Handlebar Helper Function: TimezoneConversion

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 (API version 67.0).

ParameterTypeDescription
dateString or ObjectRequired. The date to convert.
sourceTZStringRequired. The source time zone.
targetTZStringRequired. 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.

  • 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 Time
    • EST: 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.

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.