# Time and dates

> How timestamps work: observedAt in UTC, localDate at the station's fixed offset with no daylight saving, daily vs hourly periods, and the water year that starts October 1.

Snow data mixes calendar days and instants, and the source reports them in its own local time. Snotel states which one each field is.

## The source's time

NRCS reports a station's times in the station's local standard time as a fixed offset from UTC. There is no daylight saving adjustment, so the offset is the same all year. Banner Summit in Idaho reports at UTC−8, for example, even though most of Idaho is in the Mountain time zone. The offset is a property of the station, so read it rather than assuming it from the state.

A daily value is dated by a calendar day in that time, such as `2024-02-01`. An hourly value is stamped with a date and an hour, such as `2024-02-01 06:00`.

## How Snotel stores time

Each observation keeps three things, so nothing is lost or silently shifted:

- `observedAt`, the UTC instant at which the observation's period starts.
- `utcOffsetMinutes`, the source's offset, for example `-480` for UTC−8.
- `localDate`, the calendar date in the source's time.

A daily value for `2024-02-01` at UTC−8 starts at midnight local time, which is `2024-02-01T08:00:00Z`, and its `localDate` is `2024-02-01`. The local date is the observation instant shifted by the offset:

```ts
const observedAt = new Date("2024-02-01T08:00:00Z");
const utcOffsetMinutes = -480;

const shifted = new Date(observedAt.getTime() + utcOffsetMinutes * 60_000);
shifted.toISOString().slice(0, 10); // "2024-02-01"
```

Use `localDate` when you mean the station's day, and `observedAt` when you need to compare across stations or with other systems.

## Daily and hourly

A daily value covers the whole calendar day and is not an instant, so do not give it a time of day. An hourly value is a point in time within the day. Do not compare them as if they covered the same period.

## The water year

The water year runs from October 1 to September 30 and is named for the year in which it ends, so water year 2024 started on October 1, 2023. Precipitation accumulation resets at the start of each water year, which is why `PREC` readings fall back to near zero every October. Snow accumulates over the winter, so the water year is the natural unit for a snow season; see [measurements](https://opensnotel.com/docs/data/measurements.md#precipitation).

## Next

- [Freshness](https://opensnotel.com/docs/data/freshness.md): How recent is this value? Which timestamp is the actual observation time, how often Snotel reads NRCS, when a reading counts as stale, and why a zero can still be fresh.

Canonical page: https://opensnotel.com/docs/reference/time
