Dates Utility

Dates value operations. No hidden external Service communication.

Contract Dates · 1.0.0-draft.1

Declared Types

Functions

now

Current datetime.

No Arguments

Returns: core.datetime

today

Current calendar date in the named timezone.

ArgumentTypeRequiredDefault
timezonecore.stringYes—

Returns: core.date

date

Parse yyyy-MM-dd strictly.

ArgumentTypeRequiredDefault
textcore.stringYes—

Returns: core.date

datetime

Parse an ISO datetime containing an explicit offset or Z.

ArgumentTypeRequiredDefault
textcore.stringYes—

Returns: core.datetime

parse

Parse date/datetime using an explicit pattern and policies.

ArgumentTypeRequiredDefault
textcore.stringYes—
kindcore.stringYes—
patterncore.stringYes—
timezonecore.string?Nonull
policyDates.ParsePolicy?Nonull

Returns: core.date | core.datetime

add

Add an integer amount with the rules in this contract.

ArgumentTypeRequiredDefault
valuecore.date | core.datetimeYes—
amountcore.integerYes—
unitcore.stringYes—
optionsDates.AddOptions?Nonull

Returns: core.date | core.datetime

startOfDay

Earliest valid instant on that local date; a wholly skipped date fails.

ArgumentTypeRequiredDefault
datecore.dateYes—
timezonecore.stringYes—

Returns: core.datetime

before

Same-type comparison.

ArgumentTypeRequiredDefault
leftcore.date | core.datetimeYes—
rightcore.date | core.datetimeYes—

Returns: core.boolean

after

Same-type comparison.

ArgumentTypeRequiredDefault
leftcore.date | core.datetimeYes—
rightcore.date | core.datetimeYes—

Returns: core.boolean

between

Decimal elapsed datetime difference in milliseconds/seconds/minutes/hours.

ArgumentTypeRequiredDefault
startcore.datetimeYes—
endcore.datetimeYes—
unitcore.stringYes—

Returns: core.decimal

format

String; datetime formatting requires explicit timezone, date formatting does not.

ArgumentTypeRequiredDefault
valuecore.date | core.datetimeYes—
patterncore.stringYes—
timezonecore.string?Nonull

Returns: core.string

Behavior

Search AISDL

Search the paper, references and contracts.