Skip to content
Documentation

Start of Time

The StartOfTime defines the anchor point from which the time series grid (raster) is built. It determines how intervals align and where period boundaries occur.

Version History

  • Up to version 4.0.0: Only start day and start year could be specified
  • From version 4.0.0 onwards: Full timestamp specification is supported, providing significantly more flexibility and precision

Default Value

By default, if not specified otherwise, the StartOfTime is set to 1970-01-01T00:00:00 in the configured time zone. The time series grid (raster) is then built based on this StartOfTime.

The StartOfTime is specified as a full ISO 8601 Timestamp:

YYYY-MM-DDTHH:mm:ss±HH:MM

Each component of the StartOfTime only affects intervals that are larger than that component:

Component Relevant for Intervals Impact on Grid
Year > 1 year Defines the starting year for multi-year intervals
Month > 1 month Defines which month the year starts
Day > 1 day Defines which day the month starts
Hour > 1 hour Defines which hour the day starts
Minute > 1 minute Defines which minute the hour starts
Second > 1 second Defines which second the minute starts
Offset - Ensures the timestamp is unambiguous

Gas industry standards require specific day boundaries. For a gas day starting at 06:00 (assuming time zone Europe/Berlin):

1970-10-01T06:00:00+02:00

This configuration:

  • Sets the daily boundary at 06:00 instead of midnight
  • Aligns the gas year to start on October 1st
  • Uses +02:00 because October 1st falls during daylight saving time in Europe/Berlin
  • Ensures consistency with industry conventions

Default Behavior:

  • 1970-01-01 is a Thursday
  • Weekly intervals will start on Thursday

To start weeks on Monday (for time zone Europe/Berlin):

{
"StartOfTime": "1970-01-05T00:00:00+01:00"
}

Since 1970-01-05 is a Monday, all weekly intervals will start on Monday. The offset is +01:00 because January is in standard time.

For financial years starting on a specific date (e.g., April 1st):

1970-04-01T00:00:00+01:00

The offset is +01:00 as April 1st is still in standard time in Europe/Berlin (daylight saving time typically begins in late March).

For hourly data that should align to a specific minute (e.g., measurement cycles starting at 15 minutes past the hour):

1970-01-01T00:15:00+01:00

The offset is +01:00 because January 1st is in standard time.

flask Comprehensive component analysis

Section titled “ Comprehensive component analysis”

StartOfTime: 1982-04-03T05:10:20+02:00

Component Value Relevant for Intervals Meaning/Effect
Year 1982 > 1 year The grid starts in 1982 (e.g., for a 2-year interval: 1982, 1984, 1986, …).
Month 04 > 1 month The year always starts in April.
Day 03 > 1 day The month always starts on the 3rd.
Hour 05 > 1 hour The day always starts at 05:00.
Minute 10 > 1 minute The hour always starts at minute 10 (HH:10:00).
Second 20 > 1 second The minute always starts at second 20 (HH:MM:20).
Offset +02:00 - Daylight saving time offset for Europe/Berlin.

StartOfTime: 1970-01-01T00:00:00+01:00

For standard daily data with midnight boundaries.

This is suitable for most daily time series where days should start at midnight in the configured time zone. The offset is +01:00 because January 1st is in standard time.

flask Quarter-hour data with offset

Section titled “ Quarter-hour data with offset”

StartOfTime: 1970-01-01T00:05:00+01:00

For 15-minute interval data starting at offset times.

Intervals will be: 00:05, 00:20, 00:35, 00:50, 01:05, etc. The offset is +01:00 because January 1st is in standard time.

© 2026 Volue.Version v0.6.38017 November 2026