TIMEZONENAME Procedure

The TIMEZONENAME procedure returns the text name or abbreviation for a given time zone number. To use the TIMEZONENAME procedure use the following declaration:

INTEGER PROCEDURE TIMEZONENAME(WHICH, TZ, LANGL, LANGP, TZL, TZP);
                               VALUE WHICH, TZ, LANGL, LANGP,      TZP;
                             INTEGER WHICH, TZ, LANGL,        TZL;
                             POINTER                   LANGP,      TZP;
     LIBRARY MCPSUPPORT;

The parameters for TIMEZONENAME are:

Parameter

Meaning

WHICH

If equal to 1, the procedure returns the time zone name. If equal to 2, the procedure returns the time zone abbreviation.

TZ

Time zone number in the range 1 through 88.

LANGL

Zero or length of MLS language in LANGP parameter. If LANGL is zero, then TIMEZONENAME uses the task language or the SYSTEMELANGUAGE.

LANGP

If LANGL parameter is greater than 0, then pointer is to MLS language in which the time zone name or abbreviation should be returned.

TZL

Length of time zone name or abbreviation returned by the procedure.

TZP

Pointer to array where the procedure returns the time zone name or abbreviation.

TIMEZONENAME returns the same error values as the MESSAGESEARCHER statement.