ガイド
タイムスタンプは正しいのにタイムゾーンが間違っているとき
値は正しいのに表示時刻がずれる原因をタイムゾーン視点で確認するガイドです。
timestamp値が正しくても、ユーザー表示時刻が間違うことがあります。多くは数値ではなくタイムゾーン解釈の問題です。
Know what a Unix timestamp does and does not include
Unix timestamps represent elapsed time from epoch and do not contain timezone labels.
Timezone is applied later when formatting for humans.
Map each layer in the time pipeline
List storage timezone, API serialization format, and frontend display timezone.
Many bugs come from one implicit local conversion in the middle.
Compare UTC output with user-local output
Seeing both views side by side reveals where the shift appears.
If UTC matches expected event but local output does not, formatting rules need review.
- Check locale formatting settings.
- Verify timezone passed to formatter utilities.
- Test with users in another region.
Watch daylight saving boundaries
DST changes can create repeated or missing local hours.
Run test timestamps around transition dates to catch hidden edge cases.
Write timezone rules in product docs
State whether each feature shows UTC, account timezone, or viewer-local time.
Clear display rules reduce support confusion and repeat bug reports.
Common situations
- Event time is off by a fixed number of hours.
- Server logs look correct but UI schedule is wrong.
- Support tickets mention wrong local appointment time.
- DST transitions cause one-hour surprises.
A valid timestamp still needs timezone context
Confirm where the time was created, how it was transported, and how it is finally rendered.