Time in scripts

StackState Self-hosted v5.1.x

Some scripting functions of StackState may accept a TimeSlice, Instant or Duration parameter, representing both a point in time and a range of time.

Type: TimeSlice

A time slice represents all ongoing transactions.

Type: Instant

An instant can be specified in the following ways:

• As a natural number representing the time in milliseconds since the Unix epoch. Almost all StackState response that have a time field represent time in this way. Most nodes for example have a lastUpdateTimestamp field represented in this way.

• As a string representing time according to a ISO8601 string of which nothing is omitted. Must be of format: [YYYY]-[MM]-[DD]T[HH]:[mm]:[SS]Z.

• As a string representing relative time. Relative time string start with + or -, followed by a natural number, followed by a time modifier (see section below).

Examples of valid instants:

• 1570738241087

• "2019-09-18T17:34:02.666Z"

• "-523s"

Type: Duration

A duration is specified as a natural number followed by a time modifier (see section below).

Examples of valid durations:

• "3m" - 3 minutes

• "1d" - 1 day

• "9w" - 9 weeks

Time modifiers

The following modifiers are usable for both Instant and Duration.

• s - seconds

• m - minutes (60 seconds)

• h - hours (60 minutes)

• d - days (24 hours)

• w - weeks (7 days)