STD.Date.TimeZone.FindTZData( timeZoneAbbrev, [location ])
| timeZoneAbbrev | REQUIRED. The time zone abbreviation to search for; must be a non-empty uppercase string. |
| location | OPTIONAL. The name of the location to search for; if a location is not provided or is an empty string, all records matching only the abbreviation are returned. |
| Returns: | A new DATASET(TZDataLayout) containing the found records.
EXPORT TZDataLayout := RECORD
STRING5 tzAbbrev; // Time zone abbreviation; always uppercase
// may be duplicated between records
INTEGER4 secondsOffset; // Number of seconds east (positive)
// or west (negative) of UTC
SET OF STRING15 locations; // Names of locations that use the given
//time zone abbreviation
END;
|
The STD.Date.TimeZone.TZDataForLocation function returns the time zone records for a given abbreviation and optional location. A location should be provided as a method of differentiation if the abbreviation has duplicate entries.
Example:
IMPORT STD;
STD.Date.TimeZone.FindTZData('CST','NORTH AMERICA');See Also: TZDataForLocation