CalendarParts

CalendarParts: {
  year: number
  month: number
  day: number
  hour: number
  minute: number
  second: number
  weekday: Weekday
  weekOfYear: number
  dayOfYear: number
  quarter: number
}

The record of local calendar fields returned by parts.

Remarks

Returned by parts. Every field is local to the zone that was passed in.

Field	Range	Notes
year
month	1–12	January is 1, not 0
day	1–31	Day of the month
hour	0–23
minute	0–59
second	0–59
weekday	see Weekday	Lower-case name
weekOfYear	1–53	ISO 8601 week number
dayOfYear	1–366
quarter	1–4	1 covers January–March

month and day are one-based, as they are when you write a date literal. weekOfYear is the ISO 8601 week number, so a date in early January may belong to the last week of the previous year.

Examples

import 'calendar'

from 2026-08-15T22:30:00Z parts 'Europe/Stockholm'

// Returns:
// 22:30 UTC is already the 16th in Stockholm
{
  year = 2026,
  month = 8,
  day = 16,
  hour = 0,
  minute = 30,
  second = 0,
  weekday = 'sunday',
  weekOfYear = 33,
  dayOfYear = 228,
  quarter = 3
}