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.0onwards: 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.
Structure and Components
Section titled “Structure and Components”The StartOfTime is specified as a full ISO 8601 Timestamp:
YYYY-MM-DDTHH:mm:ss±HH:MMEach 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 |
Common Use Cases
Section titled “Common Use Cases”Gas Days and Gas Years
Section titled “Gas Days and Gas Years”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:00This configuration:
- Sets the daily boundary at 06:00 instead of midnight
- Aligns the gas year to start on October 1st
- Uses
+02:00because October 1st falls during daylight saving time inEurope/Berlin - Ensures consistency with industry conventions
Weekly Time Series
Section titled “Weekly Time Series”Default Behavior:
1970-01-01is a Thursday- Weekly intervals will start on Thursday
Start weeks on Monday
Section titled “ Start weeks on Monday”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.
Financial Years
Section titled “Financial Years”For financial years starting on a specific date (e.g., April 1st):
1970-04-01T00:00:00+01:00The offset is +01:00 as April 1st is still in standard time in Europe/Berlin (daylight saving time typically begins in late March).
Custom Hourly Boundaries
Section titled “Custom Hourly Boundaries”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:00The offset is +01:00 because January 1st is in standard time.
Examples
Section titled “Examples”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. |
Standard daily data
Section titled “ Standard daily data”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.
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.