About Time Zones

Wix Calendars serves as the single source of truth for time zone calculations. These calculations rely on the IANA Time Zone Database and incorporate any daylight savings time adjustments. If your system uses an external time zone database, IANA time zone rule changes may arrive at different times than they reach Wix.

Default business time zone

A Wix site’s time zone is determined by the timeZone field in the getSiteProperties() response, which aligns with the primary business address’s time zone. By default, schedules and events inherit this business time zone. However, you can customize time zone settings individually for each schedule and event as needed.

When a business time zone changes

If a business updates its primary address to a location in a different time zone, the Calendar APIs make these adjustments:

• All schedules are automatically set to the new time zone.
• Future events are rescheduled to keep the same local time. For example, if an event is scheduled for 8
  AM in New York and the primary business address changes to Seattle, the event is adjusted to 8
  AM Seattle time, with UTC values updated accordingly.

IANA time zone rule changes

Occasionally, official time zone rules are updated, such as adjustments to daylight saving time or changes in a region’s standard time. Systems that rely on these rules need to synchronize with these updates to ensure accurate scheduling.

You can detect such updates in Wix Calendars by listening to onEventUpdated(). If the event's payload indicates that event.start.utcDate or event.end.utcDate has changed while event.start.localDate or event.end.localDate remains the same, Wix Calendars has applied an IANA time zone rule change.

Display schedules and events in local times

You can retrieve and manage schedules and events while displaying them in a specific time zone, making it easy to show local times to users in various regions. Specify the desired timeZone in your request, then use the adjustedStart and adjustedEnd fields in the response to display the times in the requested time zone.