Timezone Toolkit

Components and Math

TZ_ADD

Adds or subtracts a duration in a zone.

Syntax

=TZ_ADD(datetime, zone, amount, unit, [format])

Parameters

Namedatetime
Typetext, number, date, or range
DescriptionThe date/time interpreted in zone.
Namezone
Typetext
DescriptionIANA time zone.
Nameamount
Typenumber
DescriptionAmount to add. Use a negative number to subtract.
Nameunit
Typetext
Descriptionyears, months, weeks, days, hours, minutes, or seconds.
Nameformat?
Typetext
DescriptionOptional output preset or format pattern.

Returns

The resulting local date/time.

Example

=TZ_ADD("2026-03-08 01:30", "America/New_York", 2, "hours")

Result: 2026-03-08 04:30:00

    xs