({{, (RefLink[TimeZone, paclet:ref/TimeZone])
is an option for (RefLink[DateObject, paclet:ref/DateObject]), (RefLink[DateString, paclet:ref/DateString]), and related functions that specifies the time zone to use for dates and times. }})

OpenersNotesSection(Spacer1)Details

(RefLink[TimeZone, paclet:ref/TimeZone])->z specifies that results should be returned for a time zone in which z hours must be added to Greenwich Mean Time (GMT) to obtain local time.

(RefLink[TimeZone, paclet:ref/TimeZone])->"zone" specifies that results should be returned using the appropriate offset for the time zone "zone" on the appropriate date.

The typical default setting is TimeZone:>(RefLink[$TimeZone, paclet:ref/$TimeZone]).

US Eastern Standard Time (EST) corresponds to time zone -5.

For numeric values, daylight saving time corrections must be included in the time zone, so US Eastern Daylight Time (EDT) corresponds to time zone -4.

Example time zone strings include "America/Chicago", "Europe/London", "Asia/Tokyo", and "Zulu".

Settings for (RefLink[TimeZone, paclet:ref/TimeZone]) should be an (RefLink[Integer, paclet:ref/Integer]), (RefLink[Real, paclet:ref/Real]), or time zone (RefLink[String, paclet:ref/String]).

A list of available time zone entities can be found using (RefLink[EntityList, paclet:ref/EntityList])[(StringTypeLink["TimeZone", paclet:ref/interpreter/TimeZone])].

(RefLink[DateObject, paclet:ref/DateObject]) and (RefLink[TimeObject, paclet:ref/TimeObject]) expressions support (RefLink[TimeZone, paclet:ref/TimeZone])->(RefLink[None, paclet:ref/None]).

OpenersPrimaryExamplesSection(Spacer1)Examples  (4)

OpenersExampleSection0(Spacer1)Basic Examples  (1)

DateObject[TimeZone->"Zulu"]

Table[DateString[TimeZone->i],{i,0,6}]

OpenersExampleSection1(Spacer1)Scope  (3)

(RefLink[TimeZone, paclet:ref/TimeZone]) values can be an (RefLink[Integer, paclet:ref/Integer]), (RefLink[Real, paclet:ref/Real]), or time zone (RefLink[String, paclet:ref/String]):

DateObject[{2015,3,8,0,0,0},TimeZone->-5]

DateObject[{2015,3,8,0,0,0},TimeZone->-5.0]

DateObject[{2015,3,8,0,0,0},TimeZone->(Entity["America/Chicago", Entity["TimeZone","America/Chicago"], "Entity[\"TimeZone\", \"America/Chicago\"]", "time zone"])]

Time zone strings will account for daylight saving time automatically:

DateObject[{2015,3,8,1,0,0},TimeZone->"America/Chicago"]

DateObject[{2015,3,8,3,0,0},TimeZone->"America/Chicago"]

(RefLink[EntityList, paclet:ref/EntityList])[(StringTypeLink["TimeZone", paclet:ref/interpreter/TimeZone])] can be used to find available (StringTypeLink["TimeZone", paclet:ref/interpreter/TimeZone]) entities:

EntityList["TimeZone"]//Shallow

({{DocumentationFooterIconsRelatedFunction.png, ({{See Also}, {(RefLink[$TimeZone, paclet:ref/$TimeZone])  ▪  (RefLink[$TimeZoneEntity, paclet:ref/$TimeZoneEntity])  ▪  (RefLink[TimeZoneConvert, paclet:ref/TimeZoneConvert])  ▪  (RefLink[TimeZoneOffset, paclet:ref/TimeZoneOffset])  ▪  (RefLink[LocalTimeZone, paclet:ref/LocalTimeZone])  ▪  (RefLink[DateObject, paclet:ref/DateObject])  ▪  (RefLink[LocalTime, paclet:ref/LocalTime])  ▪  (RefLink[DateString, paclet:ref/DateString])  ▪  (RefLink[DateList, paclet:ref/DateList])  ▪  (RefLink[AbsoluteTime, paclet:ref/AbsoluteTime])}})}})

({{DocumentationFooterIconsRelatedTutorial.png, ({{Tutorials}, {▪(RefLinkPlain[Date and Time Functions, paclet:tutorial/DateAndTimeFunctions])}})}})

({{DocumentationFooterIconsRelatedGuide.png, ({{Related Guides}, {▪(RefLinkPlain[Setting Up Input Interpreters, paclet:guide/InterpretingStrings])}, {▪(RefLinkPlain[Free-Form & External Input, paclet:guide/FreeFormAndExternalInput])}})}})