← Bookings, calendars and scheduling
How does my app handle time zones?
Short answer
Your AI can keep each booking's time in UTC, the world's reference time, and show it on each person's clock; tell it your time zone.
Deeper
A time zone is the region whose clock a person lives by, such as Europe/Oslo. The same moment is 10:00 on one clock and 09:00 on another, so a booking app must know which clock each time means.
What GilbPlatform does today. A time in a record, one piece of data with its own address, is kept as a date, or as a moment in UTC, the world's reference time; the developer answer How do I write values of each kind (encodings)? says more. GilbVeda, the shared list of terms, has a Time Zone term, and GilbApp can show a time zone on a person's card; the answer How do I add a person's addresses and time zone? shows how. For programs, GilbPlatform can turn words for a time into an exact time; GilbPlatform never uses the time zone of the computer it runs on and never guesses one, so the program must name the zone. The developer answer How do I turn time words into a date? tells more.
What your app does. Your AI builds this: it keeps each booking as one moment in UTC, works out your free times on your own clock, and shows each visitor the time on theirs. A browser can tell your app the time zone the visitor's computer is set to; Mozilla's guide for web developers says the default is the runtime's default time zone (https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/resolvedOptions, read 13 November 2026). Showing the zone's name beside each time helps people who travel.
When the clocks change. In many places the clocks move an hour in spring and in autumn, so a clock time can be missing once a year, or come twice. GilbPlatform's time words then answer that the time is not clear, instead of guessing; your app must decide what to do, for example not offer that time.
Tell Kai-Zen, the planning agent, which time zone your opening hours are in, and whether your customers may be in other zones; it changes the plan, and Agent.Coder, the agent that writes your app's code, builds the change. You can ask your AI to test a booking made from another time zone, and one on the night the clocks change.
This answer is written for a computer screen.
Source: GilbPlatform 0fc5a548 (https://id.gilb.com/version, read 13 November 2026): no booking, calendar, e-mail-sending or timed-job route for apps in src/routes (e-mail is sent only for sign-in codes, src/auth/send-otc-email.ts, and the owner's monitor alerts). GilbApp 49b1ae53 (https://gilb.com/app/version.json, read 13 November 2026): no booking or calendar control in src. GilbVeda t:TimeZone (Suggested). Mozilla, Intl.DateTimeFormat.prototype.resolvedOptions(), https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/resolvedOptions, read 13 November 2026. Live help pages, sentences shared: How do I turn time words into a date? (never uses the server's own time zone and never guesses one; local-time-ambiguous for a clock time that does not exist, or comes twice); How do I write values of each kind (encodings)? (a date, or a UTC time ending in Z); How do I add a person's addresses and time zone?; What are space and time in GilbVeda (changing systems)?
Checked against GilbApp d529620.