Converts a canonical time zone value to a human-readable text string.

Syntax

@TimeZoneToText( timeZone ; formatString )

Parameters

timeZone

Canonical time zone value or list thereof. Use a Lotus Notes Time zone field to create a time zone value.

Optional. String consisting of one or more of the following format specifiers:

Format specifier	Returns
S	Short time zone string, for example: "GMT-08:00"
A	Alias for local time zone. For example, if the zone is the same as the zone in which the system is running, returns: "Local time"

string

The time-date value converted to a string. If you do not include a format specifier, a long time zone label is returned. For example:

"(GMT-08:00) Pacific Time (US & Canada);Tijuana"

If the first parameter is a list, the function operates on each list element, and the return value is a list with the same number of elements.

This function is useful for displaying the contents of a Time zone field in a view. If you do not use this function, a Time zone field value displays in the view with a format similar to the following:

Z=9$DO=1$DL=4 1 1 10-1 1$ZX=1$ZN=Alaskan

Also use this function with the @GetCurrentTimeZone function to translate the time zone value it returns into a readable string.

Example
See Also

Converting data types
Time-date constants

Glossary