Guía
Cuando el timestamp parece correcto pero la zona horaria está mal
Cómo detectar casos donde el número es válido pero la hora mostrada no coincide.
Un timestamp puede ser técnicamente correcto y aun así mostrar una hora incorrecta para el usuario. El problema suele ser de interpretación de zona horaria.
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.