expression (string);input (json 5);output (json 5)

# Date function basics
d('2023-10-15');;'2023-10-15T00:00:00Z'
d('2023-10-15 14:30');;'2023-10-15T14:30:00Z'
d('2023-10-15 14:30:45');;'2023-10-15T14:30:45Z'
d('2023-10-15', 'Europe/Berlin');;'2023-10-15T00:00:00+02:00'
d('2023-10-15 14:30', 'Europe/Berlin');;'2023-10-15T14:30:00+02:00'
d('2023-10-15 14:30:45', 'Europe/Berlin');;'2023-10-15T14:30:45+02:00'
d('Europe/Berlin').isValid() and d('Europe/Berlin').isToday();;true

# ISO 8601 forms
d('2023-10-15T14:30');;'2023-10-15T14:30:00Z'
d('2023-10-15T14:30:45');;'2023-10-15T14:30:45Z'
d('2023-10-15T14:30:45.123').format('%Y-%m-%d %H:%M:%S%.3f');;'2023-10-15 14:30:45.123'
d('2023-10-15 14:30:45.5').format('%Y-%m-%d %H:%M:%S%.3f');;'2023-10-15 14:30:45.500'
d('2023-10-15T14:30Z');;'2023-10-15T14:30:00Z'
d('20231015T143045Z');;'2023-10-15T14:30:45Z'
d('20231015T1430');;'2023-10-15T14:30:00Z'
d('20231015');;'2023-10-15T00:00:00Z'
d('2023/10/15');;'2023-10-15T00:00:00Z'
d('2023/10/15 14:30');;'2023-10-15T14:30:00Z'
d('2023-10');;'2023-10-01T00:00:00Z'
d('2023');;'2023-01-01T00:00:00Z'
d('2023-10-15T14:30', 'Europe/Berlin');;'2023-10-15T14:30:00+02:00'
d('2023-13').isValid();;false
d('2023-02-30').isValid();;false
d('12345').isValid();;false
d('202310').isValid();;false
d('hello').isValid();;false
d('2023105').isValid();;false
d('2023011').isValid();;false
d('2023101T1430').isValid();;false
d('2023 1015').isValid();;false
d('+2023-1').isValid();;false
d('2023/1/5 1:2').isValid();;false
d('2023-10-15T14:30:45  Z').isValid();;false
d('-262143-01-01T00:00:00Z').isValid();;false
d('-262143-01-01', 'Asia/Tokyo').isValid();;false

# Offsets keep the instant
d('2023-10-15T14:30+0200');;'2023-10-15T12:30:00Z'
d('2023-10-15T14:30:45-0530');;'2023-10-15T20:00:45Z'
d('2023-10-15T14:30:45+02');;'2023-10-15T12:30:45Z'
d('2023-10-15T14:30:00+05:00');;'2023-10-15T09:30:00Z'
d('2023-10-15T14:30:00+05:00').hour();;9
d('2023-10-15T14:30:00+05:00', 'Europe/Berlin');;'2023-10-15T11:30:00+02:00'
d(d('2023-10-15T12:00:00Z'), 'Europe/Berlin');;'2023-10-15T14:00:00+02:00'
d('2023-10-15T14:30:00+05:00') == d('2023-10-15T09:30:00Z');;true

# Local times inside a DST gap move forward by the gap
d('2024-03-31 02:30', 'Europe/Berlin');;'2024-03-31T03:30:00+02:00'
d('2024-03-31T02:30:00Z', 'Europe/Berlin');;'2024-03-31T04:30:00+02:00'

# Dates compared with strings
d('2023-10-15') == '2023-10-15';;true
'2023-10-15' == d('2023-10-15');;true
d('2023-10-15') == '2023-10-16';;false
d('2023-10-15') != '2023-10-15';;false
d('2023-10-15') > '2023-10-14';;true
'2023-10-14' < d('2023-10-15');;true
d('2023-10-15') in ['2023-10-14', '2023-10-15'];;true
'2023-10-15' in [d('2023-10-15')];;true
contains([d('2023-10-15')], '2023-10-15');;true
string(d('2023-10-15'));;'2023-10-15T00:00:00Z'
'on ' + d('2023-10-15');;'on 2023-10-15T00:00:00Z'
year(d('2023-10-15'));;2023

# Date manipulation
d('2023-10-15').add('1d');;'2023-10-16T00:00:00Z'
d('2023-10-15').add('1d 5h');;'2023-10-16T05:00:00Z'
d('2023-10-15').add(1, 'd');;'2023-10-16T00:00:00Z'
d('2023-10-15').sub('2d');;'2023-10-13T00:00:00Z'
d('2023-10-15').sub(1, 'M');;'2023-09-15T00:00:00Z'

# Date comparisons
d('2023-10-15').isBefore(d('2023-10-16'));;true
d('2023-10-15').isBefore(d('2023-10-15'));;false
d('2023-10-15').isAfter(d('2023-10-14'));;true
d('2023-10-15').isAfter(d('2023-10-15'));;false
d('2023-10-15').isSame(d('2023-10-15'));;true
d('2023-10-15').isSame(d('2023-10-16'));;false
d('2023-10-15').isSameOrBefore(d('2023-10-15'));;true
d('2023-10-15').isSameOrBefore(d('2023-10-16'));;true
d('2023-10-15').isSameOrBefore(d('2023-10-14'));;false
d('2023-10-15').isSameOrAfter(d('2023-10-15'));;true
d('2023-10-15').isSameOrAfter(d('2023-10-14'));;true
d('2023-10-15').isSameOrAfter(d('2023-10-16'));;false

d('2025-02-01').isAfter(d('2025-01-05'), 'year');;false
d('2025-02-01').isAfter(d('2024-12-31'), 'year');;true
d('2025-02-01').isBefore(d('2025-03-01'), 'year');;false
d('2025-02-01').isBefore(d('2026-01-01'), 'year');;true
d('2025-02-01').isSame(d('2025-12-31'), 'year');;true
d('2025-02-01').isSame(d('2026-01-01'), 'year');;false

d('2025-02-15').isAfter(d('2025-01-05'), 'month');;true
d('2025-02-15').isAfter(d('2025-02-05'), 'month');;false
d('2025-02-15').isBefore(d('2025-03-01'), 'month');;true
d('2025-02-15').isBefore(d('2025-02-28'), 'month');;false
d('2025-02-15').isSame(d('2025-02-28'), 'month');;true
d('2025-02-15').isSame(d('2025-03-01'), 'month');;false
d('2025-04-15').isAfter(d('2025-01-01'), 'quarter');;true
d('2025-02-15').isAfter(d('2025-03-31'), 'quarter');;false
d('2025-02-15').isBefore(d('2025-04-01'), 'quarter');;true
d('2025-02-15').isBefore(d('2025-03-31'), 'quarter');;false
d('2025-02-15').isSame(d('2025-03-15'), 'quarter');;true
d('2025-02-15').isSame(d('2025-04-01'), 'quarter');;false
d('2025-02-15').isAfter(d('2025-02-14'), 'day');;true
d('2025-02-15').isAfter(d('2025-02-15'), 'day');;false
d('2025-02-15').isBefore(d('2025-02-16'), 'day');;true
d('2025-02-15').isBefore(d('2025-02-15'), 'day');;false
d('2025-02-15').isSame(d('2025-02-15 12:00:00'), 'day');;true
d('2025-02-15').isSame(d('2025-02-16'), 'day');;false

# Date getters
d('2023-10-15').year();;2023
d('2023-10-15').month();;10
d('2023-10-15').day();;15
d('2023-10-15').weekday();;7
d('2023-10-16').weekday();;1
d('2023-10-15').hour();;0
d('2023-10-15').minute();;0
d('2023-10-15').second();;0
d('2023-10-15').dayOfYear();;288
d('2023-01-01').dayOfYear();;1
d('2023-12-31').dayOfYear();;365
d('2024-12-31').dayOfYear();;366
d('2023-10-15').quarter();;4
d('2023-01-15').quarter();;1
d('2023-04-15').quarter();;2
d('2023-07-15').quarter();;3
d('2023-10-15').timestamp();;1697328000000
d('2023-10-15', 'Europe/Berlin').offsetName();;'Europe/Berlin'
d('2023-10-15', 'America/Los_Angeles').offsetName();;'America/Los_Angeles'
d('2023-10-15').isLeapYear();;false
d('2024-10-15').isLeapYear();;true
d('2000-10-15').isLeapYear();;true
d('1900-10-15').isLeapYear();;false

# Date setters
d('2023-10-15').set('year', 2024);;'2024-10-15T00:00:00Z'
d('2023-10-15').set('month', 5);;'2023-05-15T00:00:00Z'
d('2023-10-15').set('day', 20);;'2023-10-20T00:00:00Z'
d('2023-10-15T10:30:00Z').set('hour', 15);;'2023-10-15T15:30:00Z'
d('2023-10-15T10:30:00Z').set('minute', 45);;'2023-10-15T10:45:00Z'
d('2023-10-15T10:30:00Z').set('second', 30);;'2023-10-15T10:30:30Z'

# Special date checks
d().isSame(d(), 'day');;true
d('2023-10-15').startOf('day');;'2023-10-15T00:00:00Z'
d('2023-10-15T10:30:45Z').startOf('hour');;'2023-10-15T10:00:00Z'
d('2023-10-15').endOf('day');;'2023-10-15T23:59:59Z'
d('2023-10-15T10:30:45Z').endOf('hour');;'2023-10-15T10:59:59Z'
d('2023-10-15').startOf('month');;'2023-10-01T00:00:00Z'
d('2023-10-15').endOf('month');;'2023-10-31T23:59:59Z'
d('2023-10-15').startOf('year');;'2023-01-01T00:00:00Z'
d('2023-10-15').endOf('year');;'2023-12-31T23:59:59Z'
d('2023-10-15').startOf('week');;'2023-10-09T00:00:00Z'
d('2023-10-15').endOf('week');;'2023-10-15T23:59:59Z'
d('2024-01-15').startOf('week');;'2024-01-15T00:00:00Z'
d('2024-01-15').endOf('week');;'2024-01-21T23:59:59Z'
d('2024-01-16').endOf('week');;'2024-01-21T23:59:59Z'
d('2024-01-21').endOf('week');;'2024-01-21T23:59:59Z'
d('2023-10-15').startOf('quarter');;'2023-10-01T00:00:00Z'
d('2023-10-15').endOf('quarter');;'2023-12-31T23:59:59Z'
d('2023-03-15').startOf('quarter');;'2023-01-01T00:00:00Z'
d('2023-03-15').endOf('quarter');;'2023-03-31T23:59:59Z'
d('2023-06-15').startOf('quarter');;'2023-04-01T00:00:00Z'
d('2023-06-15').endOf('quarter');;'2023-06-30T23:59:59Z'
d('2023-09-15').startOf('quarter');;'2023-07-01T00:00:00Z'
d('2023-09-15').endOf('quarter');;'2023-09-30T23:59:59Z'

# Timezone operations
d('2023-10-15T00:00:00Z').tz('America/New_York');;'2023-10-14T20:00:00-04:00'
d('2023-10-15T00:00:00Z').tz('Europe/London');;'2023-10-15T01:00:00+01:00'
d('2023-10-15T00:00:00+00:00').tz('UTC');;'2023-10-15T00:00:00Z'
d('2023-10-15T12:00:00+02:00', 'Etc/GMT-2').tz('UTC');;'2023-10-15T10:00:00Z'

# Relative date methods
d().sub(1, 'd').isYesterday();;true
d().add(1, 'd').isTomorrow();;true
d('2023-10-15').isToday();;false

# Diff
d('2023-10-15').diff(d('2023-10-10'), 'day');;5
d('2023-10-15T10:00:00Z').diff(d('2023-10-15T08:30:00Z'), 'hour');;1
d('2023-10-15').diff(d('2023-09-15'), 'month');;1
d('2023-12-31').diff(d('2023-01-01'), 'year');;0
d('2023-12-31').diff(d('2022-01-01'), 'year');;1
d('2023-10-10').diff(d('2023-10-15'), 'day');;-5
d('2023-09-15').diff(d('2023-10-15'), 'month');;-1
d('2022-01-01').diff(d('2023-12-31'), 'year');;-1
d('2023-10-15T10:30:00Z').diff(d('2023-10-15T10:00:00Z'), 'minute');;30
d('2023-10-15T10:00:30Z').diff(d('2023-10-15T10:00:00Z'), 'second');;30
d('2023-10-22').diff(d('2023-10-15'), 'week');;1
d('2023-10-29').diff(d('2023-10-15'), 'week');;2
d('2023-07-01').diff(d('2023-01-01'), 'quarter');;2
d('2023-12-31').diff(d('2023-01-01'), 'quarter');;3
d('2023-10-15').diff(d('2023-10-15'), 'day');;0
d('2023-10-15').diff(d('2023-10-15'), 'month');;0
d('2023-10-15').diff(d('2023-10-15'), 'year');;0
d('2023-03-31').diff(d('2023-02-28'), 'month');;1
d('2024-02-29').diff(d('2024-01-31'), 'month');;1
d('2023-05-31').diff(d('2023-04-30'), 'month');;1
d('2023-03-31').diff(d('2023-02-28'), 'month');;1
d('2023-02-28').diff(d('2023-01-31'), 'month');;1
d('2023-04-30').diff(d('2023-03-31'), 'month');;1
d('2024-02-29').diff(d('2023-02-28'), 'year');;1
d('2023-12-31').diff(d('2023-01-01'), 'year');;0
d('2024-01-01').diff(d('2023-01-01'), 'year');;1
d('2025-01-01').diff(d('2020-01-01'), 'year');;5
d('2023-12-01').diff(d('2023-01-01'), 'month');;11
d('2023-12-31').diff(d('2023-01-01'), 'day');;364
d('2023-10-15T12:00:00Z').diff(d('2023-10-15T10:30:00Z'), 'hour');;1
d('2023-10-16T12:00:00Z').diff(d('2023-10-15T18:00:00Z'), 'day');;0

# Formatting
d('2023-10-15').format('%Y-%m-%d');;'2023-10-15'
d('2023-10-15').format('%Y/%m/%d');;'2023/10/15'
d('2023-10-15T14:30:45Z').format('%A, %B %d %Y, %H:%M:%S');;'Sunday, October 15 2023, 14:30:45'
d('2023-10-15T14:30:45Z').format('%a %b %d %H:%M');;'Sun Oct 15 14:30'
d('2023-10-15T14:30:45Z').format('Day %j of year %Y');;'Day 288 of year 2023'
d('2023-10-15T14:30:45.123Z').format('%H:%M:%S.%f');;'14:30:45.123000000'

# Date validations
d(null).isValid();;false
d('foo').isValid();;false
d('2023-13-01').isValid();;false
d('2023-02-30').isValid();;false

# Date comparison operators
d('2023-10-15') == d('2023-10-15');;true
d('2023-10-15') == d('2023-10-16');;false
d('2023-10-15') != d('2023-10-16');;true
d('2023-10-15') != d('2023-10-15');;false
d('2023-10-15') < d('2023-10-16');;true
d('2023-10-15') < d('2023-10-15');;false
d('2023-10-15') <= d('2023-10-15');;true
d('2023-10-16') <= d('2023-10-15');;false
d('2023-10-16') > d('2023-10-15');;true
d('2023-10-15') > d('2023-10-15');;false
d('2023-10-15') >= d('2023-10-15');;true
d('2023-10-15') >= d('2023-10-16');;false

# Date range operators
d('2023-10-15') in [d('2023-10-01')..d('2023-10-31')];;true
d('2023-10-01') in [d('2023-10-01')..d('2023-10-31')];;true
d('2023-10-31') in [d('2023-10-01')..d('2023-10-31')];;true
d('2023-09-30') in [d('2023-10-01')..d('2023-10-31')];;false
d('2023-11-01') in [d('2023-10-01')..d('2023-10-31')];;false

d('2023-10-15') in (d('2023-10-01')..d('2023-10-31'));;true
d('2023-10-01') in (d('2023-10-01')..d('2023-10-31'));;false
d('2023-10-31') in (d('2023-10-01')..d('2023-10-31'));;false
d('2023-10-02') in (d('2023-10-01')..d('2023-10-31'));;true
d('2023-10-30') in (d('2023-10-01')..d('2023-10-31'));;true

d('2023-10-15') in [d('2023-10-01')..d('2023-10-31'));;true
d('2023-10-01') in [d('2023-10-01')..d('2023-10-31'));;true
d('2023-10-31') in [d('2023-10-01')..d('2023-10-31'));;false
d('2023-10-30') in [d('2023-10-01')..d('2023-10-31'));;true

d('2023-10-15') in (d('2023-10-01')..d('2023-10-31')];;true
d('2023-10-01') in (d('2023-10-01')..d('2023-10-31')];;false
d('2023-10-31') in (d('2023-10-01')..d('2023-10-31')];;true
d('2023-10-02') in (d('2023-10-01')..d('2023-10-31')];;true

d('2023-10-15') not in [d('2023-10-01')..d('2023-10-31')];;false
d('2023-09-30') not in [d('2023-10-01')..d('2023-10-31')];;true
d('2023-11-01') not in [d('2023-10-01')..d('2023-10-31')];;true

d('2023-10-01') not in (d('2023-10-01')..d('2023-10-31'));;true
d('2023-10-31') not in (d('2023-10-01')..d('2023-10-31'));;true
d('2023-10-15') not in (d('2023-10-01')..d('2023-10-31'));;false

d('2023-10-31') not in [d('2023-10-01')..d('2023-10-31'));;true
d('2023-10-01') not in (d('2023-10-01')..d('2023-10-31')];;true


min([d('2023-01-15'), d('2023-03-20'), d('2023-02-10')]);;'2023-01-15T00:00:00Z'
max([d('2023-01-15'), d('2023-03-20'), d('2023-02-10')]);;'2023-03-20T00:00:00Z'
min([d('2023-10-15'), d('2023-10-01'), d('2023-10-31')]);;'2023-10-01T00:00:00Z'
max([d('2023-10-15'), d('2023-10-01'), d('2023-10-31')]);;'2023-10-31T00:00:00Z'
min([d('2023-10-15T10:30:00Z'), d('2023-10-15T08:15:00Z'), d('2023-10-15T14:45:00Z')]);;'2023-10-15T08:15:00Z'
max([d('2023-10-15T10:30:00Z'), d('2023-10-15T08:15:00Z'), d('2023-10-15T14:45:00Z')]);;'2023-10-15T14:45:00Z'
min([d('2022-12-31'), d('2023-01-01'), d('2024-01-01')]);;'2022-12-31T00:00:00Z'
max([d('2022-12-31'), d('2023-01-01'), d('2024-01-01')]);;'2024-01-01T00:00:00Z'
min([d('2023-10-15'), d('2023-10-15'), d('2023-10-15')]);;'2023-10-15T00:00:00Z'
max([d('2023-10-15'), d('2023-10-15'), d('2023-10-15')]);;'2023-10-15T00:00:00Z'
min([d('2023-10-15')]);;'2023-10-15T00:00:00Z'
max([d('2023-10-15')]);;'2023-10-15T00:00:00Z'
min([d('2023-10-15T10:00:00Z'), d('2023-10-15T12:00:00Z')]);;'2023-10-15T10:00:00Z'
max([d('2023-10-15T10:00:00Z'), d('2023-10-15T12:00:00Z')]);;'2023-10-15T12:00:00Z'
min([d('1900-01-01'), d('2000-01-01'), d('1950-06-15')]);;'1900-01-01T00:00:00Z'
max([d('1900-01-01'), d('2000-01-01'), d('1950-06-15')]);;'2000-01-01T00:00:00Z'
min([d('2024-02-29'), d('2023-02-28'), d('2024-03-01')]);;'2023-02-28T00:00:00Z'
max([d('2024-02-29'), d('2023-02-28'), d('2024-03-01')]);;'2024-03-01T00:00:00Z'
min([d('2023-01-31'), d('2023-02-28'), d('2023-03-31')]);;'2023-01-31T00:00:00Z'
max([d('2023-01-31'), d('2023-02-28'), d('2023-03-31')]);;'2023-03-31T00:00:00Z'
min([d('2023-10-15').add(1, 'd'), d('2023-10-15').sub(1, 'd'), d('2023-10-15')]);;'2023-10-14T00:00:00Z'
max([d('2023-10-15').add(1, 'd'), d('2023-10-15').sub(1, 'd'), d('2023-10-15')]);;'2023-10-16T00:00:00Z'
min([d('2023-01-01'), d('2023-12-31')]).isBefore(d('2023-06-01'));;true
max([d('2023-01-01'), d('2023-12-31')]).isAfter(d('2023-06-01'));;true