iOS Dates and Timezones: Stop the Clock From Travelling on Its Own

Most “the date jumped” bugs on iOS are timezones, calendars, and storing a local clock as if it were an instant. The phone did not travel through time. The formatter did.

CodeLoop Studio in Sarajevo ships native iOS when the product needs it. Vellum is a reading tracker — streaks and sessions care about the reader’s day, not UTC dressed up as a birthday. Store delivery is shipping from Sarajevo. Native versus cross-platform is native iOS and Android.

Store instants, display zones

A booking, a measurement, a “read today” tick: decide whether the event is a moment in the universe or a civil date in the user’s calendar. Mixing them is how a flight to another country “skips” a streak, or how a hotel night lands on the wrong day. We freeze that in discovery, not in a hotfix after TestFlight.

Android has the same class of bugs with a different API surface. Play patches are in-app updates. Cross-platform does not erase the rule — Flutter vs React Native.

What we freeze

• ISO instants on the wire. Servers speak UTC. Clients format. A “date only” field is explicit, not a midnight timestamp hoping for the best.

• DST and travel. If your users fly, we test a timezone change. If they never leave one city, we still do not parse strings with DateFormatter and hope.

• Calendars you actually support. Gregorian for most product work. We will not pretend we shipped every calendar Apple lists unless the brief says so.

• No invented “time machine” demos. We will not clone a joke engineering post. We will fix the product clock. Health protocols on a phone are LipoDIETA — days and reminders, not a thought experiment.

When this is not the first ticket

If the app has no login and no stored event, timezone work can wait. If staff in two countries share a shift board, it cannot. Authentication and roles are app authentication.

Send the event that jumped

What the user saw, which timezone they were in, and whether the value is a day or a moment. Reply in 24 hours — online estimate or contact.