DateTime

1 min read

Import: import system;

Read the usage guide for examples and common tasks. This reference lists the public declarations for this part of the library. See Reading API signatures for parameter and result notation.

day_of_year

The day of the year (1-based).

public get day_of_year(): int

add

Returns the instant d after this date/time, keeping its UTC offset.

public fun add(d: Duration): DateTime

until

Returns the duration from this instant to other.

public fun until(other: DateTime): Duration

start_of_day

Returns midnight on the same calendar date, keeping this UTC offset.

public fun start_of_day(): DateTime

compare

Orders two instants by their UTC epoch milliseconds, ignoring the display offset. Returns -1 when this is earlier, 0 when equal, and 1 when later.

public fun compare(borrow other: DateTime): int

is_before

True if this is before other.

public fun is_before(other: DateTime): bool

is_after

True if this is after other.

public fun is_after(other: DateTime): bool

equals

True if this equals other.

public fun equals(other: DateTime): bool

to_iso8601

Formats as ISO-8601.

public fun to_iso8601(): string

to_string

A human-readable formatting.

public override fun to_string(): string

parse

Parses an ISO-8601 datetime (YYYY-MM-DDTHH:MM:SS[.frac][Z|±HH:MM]).

public static fun parse(text: string): Result<DateTime, ParseError>