Skip to content

Date and time library#

Importing#

|#| 'stdtime.nest' = dt

Functions#

@clock_datetime#

Synopsis:

[] @clock_datetime -> Map

Returns:

A map containing both the information from clock_time and date.

@clock_time#

Synopsis:

[] @clock_time -> Map

Returns:

A map containing the current second as second, the current minute as minute and the current hour as hour.

@date#

Synopsis:

[] @date -> Map

Returns:

A map containing the current day of the month as day, day of the week as week_day, day of the year as year_day, month as month and year as year.

@day#

Synopsis:

[] @day -> Int

Returns:

The current day of the month, from 1 to 31.

@gmt_clock_datetime#

Synopsis:

[] @gmt_clock_datetime -> Map

Returns:

A map containing both the information from gmt_clock_time and gmt_date.

@gmt_clock_time#

Synopsis:

[] @gmt_clock_time -> Map

Returns:

A map containing the same information as clock_time, but taken with the Greenwich Main Time.

@gmt_date#

Synopsis:

[] @gmt_date -> Map

Returns:

A map containing the same information as date, but taken with the Greenwich Main Time.

@high_res_time#

Synopsis:

[] @high_res_time -> Real

Returns:

A timestamp with the highest resolution available in seconds. This value has meaning only when compared with other values from the same function.

@high_res_time_ns#

Synopsis:

[] @high_res_time_ns -> Int

Returns:

A timestamp with the highest resolution available in nanoseconds. This value has meaning only when compared with other values from the same function.

@hours#

Synopsis:

[] @hours -> Int

Returns:

The current hour, from 0 to 23.

@minutes#

Synopsis:

[] @minutes -> Int

Returns:

The current minute, from 0 to 59.

@monotonic_time#

Synopsis:

[] @monotonic_time -> Real

Returns:

A timestamp in seconds such that any later timestamps will be always equal to or greater greater than previously take ones. This can be for example the time since startup. The return value has only meaning when compared with other timestamps from the same function.

@monotonic_time_ns#

Synopsis:

[] @monotonic_time_ns -> Int

Returns:

A timestamp in nanoseconds such that any later timestamps will be always equal to or greater greater than previously take ones. This can be for example the time since startup. The return value has only meaning when compared with other timestamps from the same function.

@month#

Synopsis:

[] @month -> Int

Returns:

The current month, from 1, January, to 12, December.

@seconds#

Synopsis:

[] @seconds -> Int

Returns:

The current second, from 0 to 59.

@sleep#

Synopsis:

[seconds: Byte|Int|Real] @sleep -> null

Description:

Pauses the execution for seconds seconds.

@sleep_ms#

Synopsis:

[milliseconds: Byte|Int] @sleep_ms -> null

Description:

Pauses the execution for milliseconds milliseconds.

@time#

Synopsis:

[] @time -> Real

Returns:

The time since the epoch in seconds.

@time_ns#

Synopsis:

[] @time_ns -> Int

Returns:

The time since the epoch in nanoseconds.

@week_day#

Synopsis:

[] @week_day -> Int

Returns:

The current day of the week, from 0, Sunday, to 6, Saturday.

@year#

Synopsis:

[] @year -> Int

Returns:

The current year.

@year_day#

Synopsis:

[] @year_day -> Int

Returns:

The current day of the year, from 0 to 366.

Constants#

MONTH_NAMES#

A map containing the complete month names. MONTH_NAMES.@@month --> July if '@@month' returns 7.

SHORTH_MONTH_NAMES#

A map containing three-letter month names.

WEEKDAY_NAMES#

A map containing the complete week day names.

SHORT_WEEKDAY_NAMES#

A map containing three-letter week day name.