Let us know so we can improve!
The online Trailblazer Community is now read-only. [Read the FAQ] [Get Help]
Converts a date from one time zone to another. Use this helper to show dates in the appropriate time zone for your recipients.
This helper is available in the Summer ’26 release of Marketing Cloud Next.
1{{timezoneConversion date sourceTZ targetTZ}}| Parameter | Type | Description |
|---|---|---|
date | String or Object | Required. The date to convert. |
sourceTZ | String | Required. The source time zone. |
targetTZ | String | Required. The target time zone. |
You can specify date in these formats:
US formats: MM/dd/yyyy, M/d/yyyy, MM/dd/yyyy HH:mm:ss, M/d/yyyy h:mm a, or M/d/yyyy h:mm:ss a
ISO formats: yyyy-MM-dd, yyyy-MM-dd HH:mm:ss, yyyy-MM-dd'T'HH:mm:ss, or yyyy-MM-dd'T'HH:mm:ss.SSSZ
12-hour time: M/d/yyyy h:mm a, yyyy-MM-dd h:mm a, or yyyy-MM-dd h:mm:ss a
Time-only: h:mm a or h:mm:ss a
If you specify only a time, the helper function uses the current date.
Note
Long-form English: d MMMM yyyy, MMMM d, yyyy, or EEEE, MMMM d, yyyy
Chinese and Japanese notation: yyyy年M月d日
Korean notation: yyyy년 M월 d일 or yyyy년M월d일
You can specify sourceTZ and targetTZ in these formats:
IANA time zone names, such as America/Los_Angeles, Europe/Kiev, or Asia/Hong_Kong.
Time zone abbreviations. The helper function supports these abbreviations:
UTC: Coordinated Universal TimeEST: Eastern Standard Time (North America)EDT: Eastern Daylight Time (North America)CST: Central Standard Time (North America)CDT: Central Daylight Time (North America)MST: Mountain Standard Time (North America)MDT: Mountain Daylight Time (North America)PST: Pacific Standard Time (North America)PDT: Pacific Daylight Time (North America)Using abbreviations can lead to confusion and code maintenance issues. For example, in English, “CST” can stand for “China Standard Time”, “Central Standard Time”, or “Cuba Standard Time”.
For best results, use IANA time zone names, which eliminate this ambiguity.
Note
The function returns a date-time string in ISO-8601 format (yyyy-MM-dd'T'HH:mm:ss) representing the date converted to the target time zone. You can send this output to other helper functions, such as dateDiff.
The function automatically handles Daylight Saving Time (DST) transitions based on the date provided.