Expressions

A spec may include Common Expression Language (CEL) expressions in a few locations.

rngo supplies functions and variables to access key values and improve readability.

Clock

SignatureReturnsDescriptionExample
nowtimestampA fixed clock time from right when the simulation startednow - days(30)
offsetnumberThe current offset within the simulationhz(3, hour) + (0.0001 * offset)

Time

SignatureReturnsDescriptionExample
seconds(n)durationA duration of n secondsnow + seconds(30)
seconddurationOne second, equivalent to seconds(1)now - second
minutes(n)durationA duration of n minutes (n * 60 seconds)now + minutes(3)
minutedurationOne minute (60 seconds), equivalent to minutes(1)now - minute
hours(n)durationA duration of n hours (n * 3,600 seconds)now - hours(6)
hourdurationOne hour (3,600 seconds), equivalent to hours(1)now - hour
days(n)durationA duration of n days (n * 86,400 seconds)now - days(30)
daydurationOne day (86,400 seconds), equivalent to days(1)now - day
weeks(n)durationA duration of n weeks (n * 604,800 seconds)now - weeks(8)
weekdurationOne week (604,800 seconds), equivalent to weeks(1)now - week
months(n)durationA duration of n months (n * 2,592,000 seconds, 30 days each)now - months(6)
monthdurationOne month (2,592,000 seconds, 30 days), equivalent to months(1)now - month
years(n)durationA duration of n years (n * 31,536,000 seconds, 365 days each)now - years(5)
yeardurationOne year (31,536,000 seconds, 365 days), equivalent to years(1)now - year

Frequency

SignatureReturnsDescriptionExample
hz(n, unit)frequencyA frequency of n per unit, where unit is a duration such as minute or hourhz(5, minute)