WOLFRAM

Wolfram Language & System Documentation Center

TimeZoneConvert[time,timezone]

converts the date or time object time to the specified time zone timezone.

TimeZoneConvert[time]

converts to the current $TimeZone value.

TimeZoneConvert[{time1,…,timen},timezone]

converts time1 through timen to the specified timezone.

Details
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
Properties & Relations  
Possible Issues  
See Also
Related Guides
History
Cite this Page

TimeZoneConvert

TimeZoneConvert[time,timezone]

converts the date or time object time to the specified time zone timezone.

TimeZoneConvert[time]

converts to the current $TimeZone value.

TimeZoneConvert[{time1,…,timen},timezone]

converts time1 through timen to the specified timezone.

Details

  • time specifications should be a DateObject or TimeObject expression.
  • Possible timezone specifications include:
  • nnumber of hours added to GMT
    "zone"named time zone
    Entity["TimeZone", "zone"]time zone specified by the "TimeZone" entity
    loctime zone associated with the given location
    Automaticautomatically determine the time zone
    Nonespecify no time zone information
  • For numeric values n, the value represents the number of hours that must be added to Greenwich Mean Time (GMT) to obtain local time.
  • For string specifications "zone", the result will be returned in the associated named time zone.
  • Example time zone strings include "America/Chicago", "Europe/London", "Asia/Tokyo" and "Zulu".
  • A list of available time zone entities can be found using EntityList["TimeZone"].
  • For location specifications loc, the time zone associated with the specified location Entity or GeoPosition will be used.
  • TimeZoneConvert[time,Automatic] indicates that the time zone value should be determined automatically, defaulting to $TimeZone if no time zone information is otherwise available.
  • TimeZoneConvert[time,None] will return an object with TimeZoneNone.
  • TimeZoneConvert[Missing[…],timezone] will return Missing[…].

Examples

open all close all

Basic Examples  (4)

Convert a DateObject from one time zone to another:

Wolfram Language code: TimeZoneConvert[DateObject[{2022, 1, 1, 20, 8, 3}, TimeZone -> 4], $TimeZone]
Wolfram Language code: TimeZoneConvert[DateObject[{2023, 12, 2, 14, 40, 0}, TimeZone -> -6], 2]

Convert a TimeObject from GMT to Eastern Time (North America):

Wolfram Language code: TimeZoneConvert[TimeObject[{11}, TimeZone -> 0], "America/New_York"]

Convert to the current $TimeZone:

Wolfram Language code: TimeZoneConvert[DateObject[{2025, 6, 14, 20, 44, 41.9248}, "Instant", "Gregorian", "GMT"]]

Convert to a common time zone:

Wolfram Language code: TimeZoneConvert[{DateObject[{2025, 8, 3, 2, 27, 18.6684}, "Instant", "Gregorian", -10.], DateObject[{2025, 4, 26, 23, 55, 47.4431}, "Instant", "Gregorian", -3.], DateObject[{2025, 8, 6, 16, 42, 25.4613}, "Instant", "Gregorian", -2.], DateObject[{2025, 3, 11, 16, 36, 53.6728}, "Instant", "Gregorian", -4.], DateObject[{2025, 5, 17, 18, 42, 10.8974}, "Instant", "Gregorian", -7.]}, 0]

Scope  (4)

Numeric target specifications may be an Integer, Real or Rational value:

Wolfram Language code: TimeZoneConvert[DateObject[{2021, 3, 12, 21, 53, 43}, "Instant", "Gregorian", -10.], 6]
Wolfram Language code: TimeZoneConvert[DateObject[{2020, 4, 21, 8, 3, 7}, "Instant", "Gregorian", -6.], 2.5]
Wolfram Language code: TimeZoneConvert[DateObject[{2017, 2, 4, 5, 4, 31}, "Instant", "Gregorian", -1.], 3 / 4]

Time zone ID strings are typically of the form "Country/City", where the offset rules are determined by local regulations and subject to change over time:

Wolfram Language code: TimeZoneConvert[DateObject[{2020, 8, 10, 3, 30, 0}, "Instant", "Gregorian", -3.], "America/Chicago"]
Wolfram Language code: TimeZoneConvert[DateObject[{2020, 2, 10, 3, 30, 0}, "Instant", "Gregorian", -3.], "America/Chicago"]

Target time zone specifications can be a "TimeZone" Entity, in addition to numeric offsets:

Wolfram Language code: TimeZoneConvert[DateObject[{2022, 4, 8, 14, 57, 3.195018}, "Instant", "Gregorian", -5.], Entity["TimeZone", "Asia/Tokyo"]]

When a GeoPosition or location Entity is used as the target, the time zone associated with that location will be used:

Wolfram Language code: TimeZoneConvert[DateObject[{2023, 11, 1, 3, 27, 40}, "Instant", "Gregorian", -1.], GeoPosition[{-10., -55.}]]
Wolfram Language code: TimeZoneConvert[DateObject[{2024, 6, 24, 13, 47, 36}, "Instant", "Gregorian", -5.], Entity["City", {"Bombay", "Maharashtra", "India"}]]

Properties & Relations  (1)

For dates with a time zone value of None, the original date will remain unchanged when converted:

Wolfram Language code: TimeZoneConvert[DateObject[{2022, 4, 8, 10, 0, 0}, TimeZone -> None], 8]

The reverse is also true:

Wolfram Language code: TimeZoneConvert[DateObject[{2022, 4, 8, 10, 0, 0}, TimeZone -> "America/Montreal"], None]

Possible Issues  (1)

Some Entity expressions do not have time zone information available:

Wolfram Language code: TimeZoneConvert[Now, Entity["Island", "KosIsland"]]
Wolfram Research (2014), TimeZoneConvert, Wolfram Language function, https://reference.wolfram.com/language/ref/TimeZoneConvert.html (updated 2022).

Text

Wolfram Research (2014), TimeZoneConvert, Wolfram Language function, https://reference.wolfram.com/language/ref/TimeZoneConvert.html (updated 2022).

CMS

Wolfram Language. 2014. "TimeZoneConvert." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2022. https://reference.wolfram.com/language/ref/TimeZoneConvert.html.

APA

Wolfram Language. (2014). TimeZoneConvert. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/TimeZoneConvert.html

BibTeX

@misc{reference.wolfram_2026_timezoneconvert, author="Wolfram Research", title="{TimeZoneConvert}", year="2022", howpublished="\url{https://reference.wolfram.com/language/ref/TimeZoneConvert.html}", note=[Accessed: 12-June-2026]}

BibLaTeX

@online{reference.wolfram_2026_timezoneconvert, organization={Wolfram Research}, title={TimeZoneConvert}, year={2022}, url={https://reference.wolfram.com/language/ref/TimeZoneConvert.html}, note=[Accessed: 12-June-2026]}