AbstractStaticDEFAULT_The Default date format for English and French to be used by the application
StaticDEFAULT_The Default time format for English and French to be used by the application
StaticDEFAULT_The Default date and time format for English and French to be used by the application
StaticDEFAULT_The default temporal mode to be used by the application
StaticDEFAULT_The Default time format for English and French to be used by the application
Static ReadonlyISO_The international ISO date format.
Static ReadonlyISO_The international ISO datetime format.
Static ReadonlyISO_The international ISO format without the seconds.
Static ReadonlyISO_The international ISO format without the milliseconds.
Static ReadonlyISO_The display format for international ISO date only for English and French
Static ReadonlyISO_A Default time only format for English and French
Static ReadonlyISO_A Default time only format for English and French
Static ReadonlyISO_A Default time only format for English and French
Static ReadonlyISO_The international ISO time format with seconds.
Static ReadonlyISO_The international ISO time format.
Static ReadonlyLONG_The Long date format.
Static ReadonlyLONG_The Long datetime format.
Static ReadonlyMILLISECONDS_Static ReadonlyMILLISECONDS_Static ReadonlyREGEX_Regular expression for matching ISO date strings
Static ReadonlyREGEX_Static ReadonlyTIME_Static constant indicating the local IANA time zone.
Static ReadonlyTIME_Static constant to indicate when we interpret a date as UTC. For general purposes of UTC.
StaticconvertConvert a date to milliseconds.
The date to use
OptionalinputFormat: string | string[]One or more format strings to prioritize when parsing string inputs.
OptionalinputTimezone: stringThe timezone to assume for string inputs that do not explicitly include a timezone.
Date as milliseconds
StaticcreateCreates a native Date object from a DateLike input.
This is a convenience wrapper around createDayjs that converts the validated
Dayjs instance into a native JavaScript Date.
The input date to convert. Can be:
Date objectOptionalinputFormat: string | string[]Optional format(s) for parsing string inputs.
Passed directly to createDayjs.
OptionalinputTimezone: stringOptional IANA timezone to apply if the input string has no explicit timezone and is parsed as an instant.
OptionaltemporalMode: TemporalModeDetermines how string inputs are interpreted:
"calendar": parsed as a calendar date"instant": parsed as an exact point in time
Defaults to DEFAULT_TEMPORAL_MODE.A native JavaScript Date object representing the parsed date.
StaticcreateCreates a validated Dayjs instance from a DateLike input.
This is a thin wrapper around parseDateToDayjs that ensures the resulting
Dayjs object is valid, throwing an error if parsing fails.
The input date to parse. Can be:
Date objectOptionalinputFormat: string | string[]Optional format(s) for parsing string inputs.
Passed directly to parseDateToDayjs.
OptionalinputTimezone: stringOptional IANA timezone to apply if the input string has no explicit timezone and is parsed as an instant.
OptionaltemporalMode: TemporalModeDetermines how string inputs are interpreted:
"calendar": parsed as a calendar date"instant": parsed as an exact point in time
Defaults to DEFAULT_TEMPORAL_MODE.A valid Dayjs object representing the parsed date.
StaticcreateCreate the Geoview time dimension from ESRI dimension
Esri time dimension object
True if it is ESRI Image
The Geoview time dimension
StaticcreateCreate the Geoview time dimension from OGC dimension
The OGC time dimension object or string
StaticcreateCreate a range of date object from OGC time dimension following ISO 8601
OGC time dimension values following
array of date from the dimension
StaticformatFormats a DateLike value into a string using the specified format, locale,
timezone, and temporal interpretation.
This method first normalizes the input using parseDateToDayjs, then applies
output-specific transformations such as timezone conversion, locale, and formatting.
The input date to format. Can be:
Date objectOptionalformat: string = ...The Dayjs format string used to produce the output.
Optionallocale: TypeDisplayLanguage = 'en'Locale used for formatting (e.g. month and weekday names).
OptionaloutputTimezone: string = ...IANA timezone applied to the output when formatting instant dates.
OptionaltemporalMode: TemporalMode = ...Determines how the input is interpreted:
"calendar": treated as a whole calendar day"instant": treated as an exact point in timeOptionalinputFormat: string | string[]Optional format(s) for parsing string inputs.
If provided, these are passed through to parseDateToDayjs.
OptionalinputTimezone: stringOptional IANA timezone to apply if the input string has no explicit timezone and is parsed as an instant.
OptionalwithZ: boolean = falseWhether to append a literal 'Z' to the formatted
output string.
The formatted date string.
parseDateToDayjs, ensuring consistent handling
of Date, epoch, and string values.outputTimezone.outputTimezone before formatting.StaticformatFormats a date into a short ISO-like string (YYYY-MM-DDTHH:mm:ss).
This is a convenience wrapper around formatDate that produces a compact,
timezone-aware ISO-style representation, optionally appending a Z suffix
when formatted in UTC.
The input date to format. Can be:
Date objectOptionaloutputTimezone: string = ...IANA timezone applied to the output when formatting instant dates.
OptionaltemporalMode: TemporalModeDetermines how the input is interpreted:
"calendar": treated as a calendar date"instant": treated as an exact point in timeOptionalinputFormat: string | string[]Optional format(s) for parsing string inputs.
Passed through to formatDate.
OptionalinputTimezone: string = ...IANA timezone to apply if the input string has no explicit timezone and is parsed as an instant.
A short ISO-like formatted date string.
StaticformatFormats a single date or a date range according to the specified display format, language, timezone, and temporal mode. If a second date is provided, the function returns a string representing the range in the format "date1 / date2".
The first date (or the only date) to format.
Object containing the display format for each language.
Language code to select the correct format from dateFormat.
OptionaloutputTimezone: stringThe IANA timezone to use for output formatting.
OptionalinputTemporalMode: TemporalModeWhether to interpret the input as 'calendar' or 'instant'.
Optionaldate2: DateLikeOptional second date for formatting a date range.
A formatted date string or a formatted date range string.
StaticformatFormats a single date or a date range according to the specified display format, language, timezone, and temporal mode. If a second date is provided, the function returns a string representing the range in the format "date1 / date2".
The first date (or the only date) to format.
OptionalinputTemporalMode: TemporalModeWhether to interpret the input as 'calendar' or 'instant'.
Optionaldate2: DateLikeOptional second date for formatting a date range.
A formatted date string or a formatted date range string.
StaticgetGets the default date and datetime formats based on the display date mode.
The display date mode, e.g., 'long' or undefined for default.
The default date and datetime formats for the given mode.
StaticguessAttempts to infer display date configuration from a service-provided date format string. The function inspects the format string to determine whether it contains time-related components (e.g., hours, minutes, seconds, timezone tokens). If time components are detected, it assumes:
undefined is returned.The date format string provided by the service
(e.g., "YYYY-MM-DDTHH:mm:ss").
A partial GuessedTimeInformation object containing inferred
display settings if time components are detected; otherwise undefined.
StaticguessAttempts to infer display date configuration from a service time dimension. This function analyzes an array of date values and applies heuristics based on the overall time span and time-of-day consistency to determine:
instant or calendar values.local.instant.undefined.Array of service-provided date values to analyze.
A partially populated GuessedTimeInformation object
if a confident inference can be made; otherwise undefined.
StaticguessStatichasDetermines whether a date/time format string contains any supported
time-related tokens.
The method performs a simple substring check against a predefined
list of time tokens (e.g. hours, minutes, seconds, meridiem, Unix time).
If the format is undefined, the method safely returns false.
The date/time format string to evaluate. May be undefined.
true if the format contains at least one recognized time token;
otherwise false.
StaticisChecks whether a given IANA time zone is supported by the runtime.
Validation is performed using Day.js with the timezone plugin, which relies
on the underlying Intl time zone database.
IANA time zone identifier to check
true if the time zone is valid and supported, otherwise false
StaticparseParses a date string as a calendar date, ignoring any timezone or offset semantics and preserving the civil date and time fields as-is. This function interprets the input purely in terms of its calendar components (year, month, day, and optional time), then normalizes those components by re-anchoring them in UTC. No timezone conversion is applied. This guarantees that calendar-based dates do not shift days due to timezone offsets, DST, or environment locale.
Date string to parse
OptionalinputFormat: string | string[]Optional format or list of formats used to parse the input date string
Optionalstrict: boolean = falseWhether to enforce strict parsing when using custom formats
Dayjs instance normalized to UTC using calendar semantics
StaticparseParses a DateLike input into a Dayjs object, automatically handling different types
of input and temporal modes.
Supports:
Date objects (treated as exact UTC instants)The input date. Can be:
Date objectOptionalinputFormat: string | string[]Optional format(s) for parsing string inputs. If provided, Dayjs will use these formats instead of auto-detection.
OptionalinputTimezone: stringOptional IANA timezone to apply if the input string
does not have an explicit timezone. Defaults to TIME_UTC in parseInstantDate.
OptionaltemporalMode: TemporalMode = ...Determines how string inputs are interpreted:
"instant": exact point in time"calendar": normalized to midnight local timeOptionalstrict: boolean = falseIf true, enforces strict parsing according to the
provided inputFormat.
A Dayjs object representing the parsed date.
date is a number or Date, it is parsed as a UTC instant.date is a string containing a timezone, it is treated as an "instant" date.inputTemporalMode is "calendar", the string is parsed with
parseCalendarDate and normalized to local midnight.parseInstantDate.StaticparseParses a string as an "instant" point in time into a Dayjs object. Handles:
The input date string to parse.
OptionalinputFormat: string | string[]Optional format(s) for parsing. If provided, Dayjs will use these formats instead of auto-detection.
OptionalinputTimezone: string = ...IANA timezone string to apply if the input string has no explicit timezone.
Optionalstrict: boolean = falseIf true, enforces strict parsing according to the
provided inputFormat.
A Dayjs object representing the parsed instant.
StatictryChecks if whatever is sent looks like it could be a date.
The string to parse to check if it's a date.
OptionalinputTimezone: stringThe timezone to assume for string inputs that do not explicitly include a timezone.
A native Date object representing the parsed instant in UTC or undefined if parsing fails.
Staticvalidate
Class used to handle date as ISO 8601
Exports
DateMgt