Dates

date

Gregorian date as an exact epoch-day number.

• year (number) -- year
• month (number) -- month
• day (number) -- day

dateString

Format an epoch day as ISO 8601.

• day (number) -- day

dateParts

Gregorian year, month and day fields.

• day (number) -- day

isLeapYear

Whether a Gregorian year is leap.

• year (number) -- year

daysInMonth

Days in a Gregorian month; invalid months return zero.

• year (number) -- year
• month (number) -- month

weekday

Weekday name of an epoch day.

• day (number) -- day

dayOfYear

One-based day of year.

• date (value) -- date

fromDayOfYear

Gregorian date from a one-based ordinal day.

• year (number) -- year
• ordinal (number) -- ordinal

isoWeek

ISO week year, week and weekday.

• date (value) -- date

addMonths

Add calendar months, clamping the day to the target month.

• date (value) -- date
• months (number) -- months

addYears

Add calendar years, clamping the day.

• date (value) -- date
• years (number) -- years

dateDifference

Calendar period with years, months and days.

• start (value) -- start
• end (value) -- end

julianDate

Construct a Julian calendar date record.

• year (number) -- year
• month (number) -- month
• day (number) -- day

julianEpochDay

Julian date to epoch day.

• date (value) -- date

julianFromEpochDay

Epoch day to Julian calendar fields.

• day (number) -- day

julianLeapYear

Julian leap-year rule.

• year (number) -- year

julianDaysInMonth

Days in a Julian month.

• year (number) -- year
• month (number) -- month

sakaDate

Construct an Indian national calendar date record.

• year (number) -- year
• month (number) -- month
• day (number) -- day

sakaEpochDay

Saka date to epoch day.

• date (value) -- date

sakaFromEpochDay

Epoch day to Saka calendar fields.

• day (number) -- day

sakaMonthName

Name of a Saka month.

• date (value) -- date

sakaLeapYear

Whether the Saka year is leap.

• year (number) -- year

sakaDaysInMonth

Days in a Saka month.

• year (number) -- year
• month (number) -- month

dateTime

Construct exact civil time; seconds may be rational.

• date (value) -- date
• hour (number) -- hour
• minute (number) -- minute
• second (number) -- second

dateTimeDays

Exact epoch days including time of day.

• time (value) -- time

dateTimeFromDays

Exact epoch days to civil time.

• days (number) -- days

dateTimeParts

Calendar fields, hour, minute and exact seconds.

• time (value) -- time

addSeconds

Add exact civil seconds.

• time (value) -- time
• seconds (number) -- seconds

offset

Fixed UTC offset; minutes inherit the sign of hours.

• hours (number) -- hours
• minutes (number) -- minutes

offsetSeconds

Fixed UTC offset from signed seconds.

• seconds (number) -- seconds

offsetDays

Offset as an exact fraction of a day.

• offset (value) -- offset

toUtc

Local civil time to UTC at a fixed offset.

• time (value) -- time
• offset (value) -- offset

fromUtc

UTC civil time to local time at a fixed offset.

• time (value) -- time
• offset (value) -- offset

parseDateTime

Parse ISO text into datetime, offset and has_time fields; offset is not applied.

• text (text) -- text

dateTimeString

Format civil time without an offset, retaining exact fractional seconds.

• time (value) -- time
• offset (value) -- optional fixed UTC offset; none omits it
• fractionDigits (number) -- optional fractional precision; none uses exact terminating decimals

utc

Construct UTC including valid leap seconds.

• date (value) -- date
• hour (number) -- hour
• minute (number) -- minute
• second (number) -- second

utcFromDateTime

Civil time to UTC fields.

• time (value) -- time

utcDateTime

UTC to civil time; leap seconds cannot be represented.

• utc (value) -- utc

taiMinusUtc

Exact TAI minus UTC seconds with a known flag from the bundled table.

• utc (value) -- utc

utcToTai

UTC to TAI instant with table coverage flag.

• utc (value) -- utc

taiToUtc

TAI instant to UTC with table coverage flag.

• instant (value) -- instant

taiToTt

TAI instant to TT.

• instant (value) -- instant

ttToTai

TT instant to TAI.

• instant (value) -- instant

taiToGps

TAI instant to GPS time.

• instant (value) -- instant

gpsToTai

GPS time to TAI.

• instant (value) -- instant

instantAddSeconds

Add exact SI seconds to a uniform time coordinate.

• instant (value) -- instant
• seconds (number) -- seconds

unixSeconds

Civil time to exact Unix seconds; leap seconds are excluded.

• time (value) -- time

fromUnixSeconds

Exact Unix seconds to civil time.

• seconds (number) -- seconds

nowDate

The current UTC calendar date as an epoch-day number, captured when the script run begins.

nowDateTime

The current UTC date and time as an exact civil datetime, captured when the script run begins to millisecond precision.