Break date

Date and time Pure
Break date
Value 1970-01-01T00:00:00Z
Year
Month
Day
Hour
Minute
Second
Millisecond
Weekday(Weekday)
Weekday number
Day of year
ISO week
ISO week year
Quarter
Days in month

Description

Pure function splitting a date/time into its calendar parts: year, month (1-12), day of month, hour, minute, second, millisecond, weekday (MONDAY..SUNDAY), weekdayNumber, dayOfYear, ISO week and week-year, quarter and the number of days in the month. Every part is read in the date's own time zone/offset, not converted to UTC. weekdayNumber is ISO-8601: 1 = Monday ... 7 = Sunday. isoWeekYear can differ from year around New Year (2027-01-01 is week 53 of 2026). Pair with Add to date for calendar arithmetic.

When to use

Use Break date when you need a single part of a date as a number or enum: to route on the day of the week, to check whether a date is the last day of its month (compare Day with Days in month), to group records by quarter or ISO week, or to build a custom label. All parts are read in the date’s own time zone, so pass a value from Now with the zone you care about rather than a UTC timestamp. For a formatted string, Format date/time is simpler.

Pins

Input pins

Pin Type Default Notes
Value datetime 1970-01-01T00:00:00Z The date/time to split. The parts are read in this value's own time zone or offset: 2026-10-04T01:30:00+02:00 is Sunday the 4th at 01:30 locally, even though it is still Saturday the 3rd in UTC.

Output pins

Pin Type Notes
Year integer The calendar year.
Month integer The month, 1 (January) to 12 (December).
Day integer The day of the month, 1 to 31.
Hour integer The hour of the day, 0 to 23.
Minute integer The minute, 0 to 59.
Second integer The second, 0 to 59.
Millisecond integer The millisecond, 0 to 999.
Weekday Weekday The day of the week as an enum, MONDAY to SUNDAY. Wire it into Switch to branch on the day.
Weekday number integer The day of the week as an ISO-8601 number: 1 is Monday and 7 is Sunday.
Day of year integer The day of the year, 1 to 366.
ISO week integer The ISO-8601 week number, 1 to 53. Weeks start on Monday and week 1 is the one holding the year's first Thursday.
ISO week year integer The year the ISO week belongs to. Around New Year it can differ from Year: 2027-01-01 is week 53 of 2026.
Quarter integer The quarter of the year, 1 to 4.
Days in month integer The number of days in the date's month, 28 to 31, leap years included.

Example

Route a nightly job differently on weekends. Wire the Result output of Now (with Zone set to your local zone) into the Value input of Break date, wire its Weekday output into the Value input of Switch, and add case pins for SATURDAY and SUNDAY.

See also