GetTimeZoneInfo

Generates a character-separated list of information about a specified time zone ID.

You can obtain the active model's time zone ID using the GetModelTimeZoneId function. For a list of valid time zone codes, use the ListTimeZones function.

Syntax

GetTimeZoneInfo( TimeZone );

Parameters

Parameter Name Type Description Optional? Default Value
TimeZone String A valid time zone ID. While this parameter is not optional, supplying an empty string will cause the function to use the time zone of the model that called it, where available. No n/a

Output

If successful, the function will return a character-separated string list of information about the specified time zone. The data in this list is separated with pipe symbols (|), and represents the following:

Field Description Example Value
Zone ID Marquesas Standard Time
Display name (UTC-09:30) Marquesas Islands
UTC offset -09:30:00
Offset day part 0
Offset hour part -9
Offset millisecond part 0
Offset minute part -30
Offset second part 0
Offset total ticks -342000000000
Offset total days -0.395833333333333
Offset total hours -9.5
Offset total milliseconds -34200000
Offset total minutes -570
Offset total seconds -34200

The raw CSV equivalent of this information is as follows:

Marquesas Standard Time|(UTC-09:30) Marquesas Islands|-09:30:00|0|-9|0|-30|0|-342000000000|-0.395833333333333|-9.5|-34200000|-570|-34200

If an invalid TimeZone is used, the function will return an error.