logoCaywork Knowledge

Current Date Tool Node

Returns the current date/time in a specified IANA timezone, optionally formatted.

Current Date Tool Node image

This node provides the current date and time for a requested IANA timezone. It validates the timezone, returns ISO 8601 and Unix timestamp always, and optionally returns a user-formatted string.

Actions

  • Validates the provided IANA timezone string; returns an error for invalid timezones.
  • Obtains the current date/time in the specified timezone.
  • Returns ISO 8601 datetime under iso.
  • Returns Unix timestamp (seconds) under timestamp.
  • If a strftime format (fmt) is provided, returns a formatted string under formatted.
  • Accepts inputs: fmt (optional str), tz (IANA timezone string, default "UTC").

Inputs (fields)

  • fmt (optional) — strftime format string; if omitted, no "formatted" field is returned.
  • tz — IANA timezone name (e.g., Europe/Amsterdam); defaults to UTC.

Outputs

  • iso — ISO 8601 datetime string (always present).
  • timestamp — Unix timestamp in seconds (always present).
  • formatted — strftime-formatted string (present only if fmt provided).