Timezone

Control how pickers interpret and display wall-clock time for the same UTC instant.

Each OrbitalDateTime stores a UTC instant plus an explicit DatetimeTimezone. Set appearance.timezone on pickers so parsing, labels, and scroll columns match the timezone your users expect. When toggling display timezone in UI, re-tag the bound value with OrbitalDateTime::from_instant so hours and calendar days stay consistent.

• Scheduling flows where users switch between local and UTC views
• Admin tools displaying API timestamps in the viewer's local wall time
• Cross-region reporting where the same instant must read differently by zone

• Wrap the tree in DatetimeLocale with a default timezone signal.
• Pass appearance.timezone to DateTimePicker, DatePicker, or DigitalClock.
• Keep the bound value's embedded timezone aligned with the active display mode when users switch zones.
• Format readouts with format_unix when you need display-zone text independent of the stored tag.