Class Sequence

Example: sequence.anchor(). Returns the millisecond anchor used by this grid definition.

Example: sequence.bounded(new TimeRange({ start, end })). Realizes a finite BoundedSequence over the supplied range.

Sample position controls which intervals are selected:

• 'begin' (default) — sample point is the interval's start. Includes buckets where sample ∈ [range.begin, range.end].
• 'center' — sample point is the interval's midpoint. Same inclusive range as 'begin'.
• 'end' — sample point is the interval's exclusive end (i.e. the start of the next bucket). Inclusion is left-exclusive: sample ∈ (range.begin, range.end]. This keeps the boundary case symmetric — an end-sample at exactly range.begin() would otherwise pull in an interval whose extent sits entirely before the range.

Example: sequence.kind(). Returns whether this sequence is fixed-step or calendar-aware.

Example: sequence.stepMs(). Returns the fixed interval size in milliseconds.

Example: sequence.timeZone(). Returns the IANA time zone for calendar-aware sequences, if any.

Creates an unbounded calendar-aware sequence.

Calendar sequences step by local calendar boundaries in an IANA time zone instead of by a fixed millisecond duration. Supported units are "day", "week", and "month".

Defaults:

• timeZone: "UTC"

Example: Sequence.daily(). Creates a daily fixed-step sequence.

Creates an unbounded fixed-step sequence.

The returned sequence is a grid definition, not a finite bucket list. By default the grid is anchored at Unix epoch 0, which makes independently-created sequences line up by default. Use bounded(...) or series operations like align(...) / aggregate(...) to realize a finite slice of the grid over a concrete range.

Example: Sequence.hourly(). Creates an hourly fixed-step sequence.