Convert Timezone

Uncontrolled node

Overview

The Convert Timezone node converts date and time values between different timezones. It parses an input date string from a specified source timezone, converts it to a target timezone, and outputs the result in a chosen format. This is useful for scheduling events across timezones, displaying local times to users in different regions, or standardizing timestamps in your workflow.

The node uses strict parsing to ensure the input matches the expected format exactly, and supports a wide range of date/time formats including ISO 8601, Unix timestamps, and various regional formats.

Supported Formats

The node supports the following input and output formats:

Format	Description	Example
YYYY-MM-DD	ISO date only	2025-01-15
YYYY-MM-DD HH:mm:ss	ISO datetime with space	2025-01-15 14:30:00
YYYY-MM-DDTHH:mm:ss	ISO datetime with T	2025-01-15T14:30:00
HH:mm:ss	Time only	14:30:00
MM/DD/YYYY	US date format	01/15/2025
DD/MM/YYYY	European date format	15/01/2025
YYYYMMDD	Compact date	20250115
YYYYMMDDHHmmss	Compact datetime	20250115143000
YYYY-MM	Year and month	2025-01
YYYY	Year only	2025
DD MMM YYYY	Day abbreviated month	15 Jan 2025
MMM DD, YYYY	Abbreviated month day	Jan 15, 2025
DD MMMM YYYY	Day full month	15 January 2025
MMMM DD, YYYY	Full month day	January 15, 2025
ISO	ISO 8601 format	2025-01-15T14:30:00Z
timestamp	Unix timestamp (ms)	1705326600000
timestamp_s	Unix timestamp (seconds)	1705326600

Timezones

The node accepts standard IANA timezone identifiers including:

• UTC (Coordinated Universal Time)
• America/New_York, America/Chicago, America/Denver, America/Los_Angeles (US timezones)
• Europe/London, Europe/Paris, Europe/Berlin (European timezones)
• Asia/Tokyo, Asia/Shanghai, Asia/Dubai (Asian timezones)
• Australia/Sydney, Pacific/Auckland (Pacific timezones)

Inputs

Input	Type	Description	Default
Input	Text	The date/time string to convert. Must match the specified input format exactly.	-
From Timezone	Enum	The timezone of the input date/time (e.g., America/New_York).	Local system timezone
To Timezone	Enum	The target timezone to convert to (e.g., Europe/London).	Local system timezone
Input Format	Enum	The format of the input string. Select from the supported formats table above.	YYYY-MM-DD HH:mm:ss
Output Format	Enum	The desired format for the output string. Select from the supported formats table above.	YYYY-MM-DD HH:mm:ss

Outputs

Output	Type	Description
Output	Text	The converted date/time string in the target timezone and specified output format. Returns an error object if parsing fails.

Runtime Behavior and Defaults

• Uncontrolled Operation: This node runs automatically whenever its inputs change. It does not require a run event trigger.
• Strict Parsing: The input string must exactly match the selected input format. If the format doesn't match, the node outputs an error object with details about the parsing failure.
• Timezone Defaults: If no timezone is specified, the node defaults to the local system timezone of the runtime environment.
• Timestamp Handling: When using timestamp or timestamp_s formats, the input should be a numeric value (or numeric string) representing milliseconds or seconds since Unix epoch.
• Date-Only Inputs: When using date-only formats (like YYYY-MM-DD), the time component is assumed to be midnight (00:00:00) in the source timezone.

Example Usage

Scenario: Converting a meeting time from New York to London.

1. Set Input to: 2025-03-15 09:00:00
2. Set From Timezone to: America/New_York
3. Set To Timezone to: Europe/London
4. Set Input Format to: YYYY-MM-DD HH:mm:ss
5. Set Output Format to: YYYY-MM-DD HH:mm:ss

Result: The output will be 2025-03-15 14:00:00 (assuming standard time; during daylight saving time, the offset may vary).

Alternative with ISO Output:

• Set Output Format to: ISO
• Result: 2025-03-15T14:00:00+00:00 (or appropriate timezone offset)

Error Handling: If you provide an input like 15/03/2025 but set Input Format to MM/DD/YYYY, the node will output:

{
  "error": "Could not parse input with inputFormat \"MM/DD/YYYY\": Expected MM/DD/YYYY"
}