Carthagos AnalyticsdocsDashboard
Documentation menu

Timezones

Every site reports on its own timezone, any IANA zone including +05:30 and +05:45, and a reader can switch their own view.

One clock per site, and a reader's own view

Every site has exactly one reporting timezone, and everything about the site is counted on it. A reader can look at the same numbers on another clock without changing anything.

ClockSet whereGoverns
The site's reporting timezoneSite Settings, General tabEvery reading of the site: the dashboard, widgets, the public share page, and the answers the MCP server and the assistant give. Every site has one. A site created from the dashboard starts on the timezone of the browser that created it, one created through the API starts on UTC, and an owner or admin can change it at any time.
A reader's pickThe timezone button in the dashboard header, or on the share pageThat reader's view only: the same data, cut on their clock. It is remembered for the tab and writes nothing, so nobody else's view moves.
Your account timezoneAccount, PreferencesA fallback only, for the moment before a site's own timezone has loaded. It does not override the site's clock.

Why the site owns the clock

Today, this week and this month have to mean the same thing to everyone who reads a site, or two teammates comparing numbers are comparing different days. So the site declares its clock once, and widgets and share links, which cannot ask their reader anything, use it too. A reader who wants their own day can still switch the view from the header, with a picker that searches by country, city or timezone name.

Every timezone works

Any IANA timezone can be a reporting timezone, including the ones whose offset is not a whole hour, such as India (+05:30) and Nepal (+05:45). Days are assembled from fifteen-minute buckets, so a local midnight at half past or quarter to the hour is cut exactly, and daylight saving days come out 23 or 25 hours long, as they are.

One clock that never moves

The anonymous visitor identifier rotates at UTC midnight everywhere, deliberately: letting a site pick the rotation clock would split visitors at local midnight and make sites comparable by their timezone choice. Reporting clocks change how numbers are bucketed, never how people are counted. Details under Privacy and consent.