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
TimeSlice
A time slice represents all ongoing transactions.
Type: Instant
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
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
- secondsm
- minutes (60 seconds)h
- hours (60 minutes)d
- days (24 hours)w
- weeks (7 days)
Last updated