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.
A Wix site’s time zone is determined by the timeZone field in the
Get Site Properties
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.
If a business updates its primary address to a location in a different time zone, the Calendar APIs make these adjustments:
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
Event Updated.
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.
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.