The timestamp helper returns the current date and time as a formatted string. Use it to capture the current moment in a flow -- for example, to stamp a record with the time it was processed. If you omit format, the output defaults to ISO 8601. If you omit timezone, the output defaults to UTC.
Syntax
{{timestamp format timezone}}
format -- The output format pattern (e.g. "YYYY-MM-DD HH:mm:ss"). Optional. Defaults to ISO 8601 if not specified. See Date and time format codes for all supported tokens.
timezone -- A valid IANA time zone identifier (e.g. "America/Los_Angeles"). Optional. Defaults to UTC if not specified -- the helper does not use any profile-based time zone settings. See integrator.io supported time zones for all accepted values.
Examples
Return the current time in a specific time zone
{{timestamp "HH:mm:ss" "America/Los_Angeles"}}
Example output: 08:09:09
Returns the current time in Los Angeles formatted as hours, minutes, and seconds.
Return the current date and time in UTC
{{timestamp "YYYY-MM-DD HH:mm:ss"}}
Example output: 2025-04-20 17:38:20
With no time zone specified, the output is in UTC.
Return the current timestamp in ISO 8601 format
{{timestamp}}
Example output: 2025-04-20T17:38:20.000Z
With no arguments, the helper returns the current UTC timestamp in ISO 8601 format.
Usage notes
- Always specify
timezoneexplicitly. The helper defaults to UTC, not the time zone set in your integrator.io profile. - To add or subtract time from the current timestamp, pass the output of
{{timestamp}}into the dateAdd helper. - Output values are dynamic -- example outputs in this article reflect the time the helper was called and will differ in your flow.