Builder APIConcepts
Time and time zones
Oslo time, half-open ranges, date formats, buckets across daylight saving time, and incomplete periods.
All times are Oslo time, and every range includes its start and excludes its end.
- Time zone: Europe/Oslo. Output times carry Oslo offsets, such as
2026-10-05T00:00:00+02:00: show them as they are. - Half-open ranges:
[from, to).from: "2026-10-05", to: "2026-10-12"is seven full days. - Input formats:
"YYYY-MM-DD"(Oslo midnight),"YYYY-MM"(the first of the month) or ISO 8601 with an offset, such as"2026-09-01T06:00:00+02:00". - Buckets: day, week (starting Monday) and month buckets are cut at Oslo midnight, so days when daylight saving time starts or ends have 23 or 25 hours.
- Incomplete periods: the current day, week or month is not over yet. Compare complete periods of the same length and bucket.
Time series are columnar
points.timeseries returns one shared time axis t and, per point, one array per metric, where
index i matches t[i]. That is the shape chart libraries take directly (see
A temperature chart).
null means no data, never zero. Draw gaps as gaps and never fill them with 0.