Returns the time zone setting of the current computer or of a time-date value, and indicates if daylight-saving time is observed.

The time zone is represented as the number of hours that must be added to the time-date to convert it to Greenwich Mean Time.

Syntax

@Zone
@Zone( timeDate )

Parameters

timeDate

Time-date. Optional. The time-date whose zone you want to know. You must specify both a date and a time; otherwise, @Zone returns 0.

zoneNumber.dstFlag

Number. The time zone, followed by a period, followed by a flag indicating daylight-saving time.
• For time zones east of GMT, zoneNumber is negative.
• For time zones west of GMT, zoneNumber is positive.
• When you use @Zone with no parameter, and daylight-saving time is being observed on the current computer, dstFlag is 1. If daylight-saving time is not being observed, only the zoneNumber is returned.
• When you use @Zone with a parameter, and the specified date falls within the daylight-saving time boundary, dstFlag is 1. If the date does not fall within daylight-saving time, only the zoneNumber is returned.

When used without a parameter, @Zone returns the zone and daylight-saving time setting of the current computer.

When used with the parameter currentTimeDate, @Zone returns the zone and daylight-saving time setting of currentTimeDate.

Time zones that are not full-hour increments from GMT

For time zones that are not a full hour increment from GMT, the return value is:

mmhh.dstFlag

mm is the minutes component of the time relative to GMT.

hh is the hours component of the time relative to GMT

dstFlag is .1 if daylight-saving time is being observed. Otherwise, only the mmhh is returned.

On a computer with a time zone setting ten and three-quarter hours west of GMT, with daylight-saving time enabled, @Zone returns: 4510.1

On a computer with a time zone setting nine and a half hours east of GMT, with daylight-saving time enabled, @Zone returns: -3009.1

Language cross-reference

TimeZone property of LotusScript NotesDateTime class

ZoneTime property of LotusScript NotesDateTime class

IsDST property of LotusScript NotesDateTime class

Time Zone property of LotusScript NotesInternational class

TimeZoneFmt property of LotusScript NotesViewColumn class

TimeZone property of Java DateTime class

ZoneTime property of Java DateTime class

IsDST property of Java DateTime class

Time Zone property of Java International class

TimeZoneFmt property of Java ViewColumn class

Example
See Also

Performing time-date operations

Glossary