zephyr.time

Time and duration helpers.

3 functions

now_unix

zephyr.time.now_unix()

Return the current Unix timestamp in seconds.

Returns

number

Current Unix time in seconds.

parse_duration

zephyr.time.parse_duration(value)

Parse a duration string into seconds.

Accepts s, m, h, d, and w units, including compound strings like 1h30m. Whitespace is ignored. A bare number with no unit is invalid.

Parameters

valuestring

Duration string, e.g. 1h30m.

Returns

number

The duration in seconds.

Example

lua
local seconds = zephyr.time.parse_duration("1h30m")

format_discord_timestamp

zephyr.time.format_discord_timestamp(unix, style?)

Format a Unix timestamp as Discord timestamp markup.

Parameters

unixnumber

Unix timestamp in seconds.

stylestringoptional

Discord timestamp style. Defaults to R (relative).

Returns

string

Discord timestamp markup, e.g. <t:1700000000:R>.