Skip to main content

$now

$now(picture?, timezone?) -> string
Compact type signature<s?s?:s>
Browse categories

Source: JSONata

Documentation​

Generates a UTC timestamp in ISO 8601 compatible format and returns it as a string. All invocations of $now() within an evaluation of an expression will all return the same timestamp value.

If the optional picture and timezone parameters are supplied, then the current timestamp is formatted as described by the $fromMillis() function.

Availability​

The FUME picture aliases date, dateTime, instant and time require:

Community v3.2.0+
Enterprise v3.2.0+

The default timestamp and custom picture formatting are also available in earlier releases.

Examples​

Format the evaluation timestamp with a FUME alias​

  • $now("date") returns the evaluation date, such as "2026-10-06".
  • $now("instant") returns the evaluation timestamp, such as "2026-10-06T09:30:00.000Z".

Basic usage​

  • $now() => "2017-05-15T15:12:59.152Z"

Get the type of $now()​

Input

null

Expression

$type($now())

Result

"string"

Show that repeated calls are stable within one evaluation​

Input

null

Expression

$now() = $now()

Result

true