Experience / Field guide

Localization & timezones

Make dates, messages and workflows understandable across regions.

The same instant, different locale

ONE STORED INSTANT · TWO VIEWSNEW YORK09:00Stored as one UTC instant

A stored instant appears in New York local time and format.

01 / CONTEXT

Why it matters

Localization goes beyond translated strings. Timezone choices affect schedules, reports, billing periods and notifications, while formatting affects everyday trust in the UI.

International users notice when a date, price or message is ambiguous. Localization includes formatting, translation workflow and time-based behavior, not only a language selector.

02 / DESIGN

Decisions to make

  • Store instants and user or account timezone separately.
  • Choose which dates use a user timezone and which use an account timezone.
  • Define translation ownership and fallback behavior.
  • Choose the source timezone for events and the timezone shown to each user.
  • Define translation ownership and fallback behavior for missing strings.
03 / IMPLEMENTATION

Build checklist

  • Format dates, numbers and currency with locale-aware APIs.
  • Test daylight saving transitions and month boundaries.
  • Keep timezone visible when scheduling or reporting.
  • Use locale-aware date, number and currency formatting.
  • Test daylight-saving changes, long translations and right-to-left layouts.
04 / WATCH FOR

Common mistakes

  • Treating a UTC timestamp as if it were the customer’s local calendar date.
  • Storing local wall-clock times without a timezone.
  • Building UI layouts that only fit English copy.
05 / GO DEEPER

Tools & references

4 starting points to compare or study. Check fit, maintenance, terms and current capabilities before choosing one.

BUILDING THIS NOW?

Explore the SaaSLayer approach.

See the services and developer guides behind our AWS backed SaaS building blocks.

Read SaaSLayer docs
NEXT FEATURECustomer onboarding