3.59 GWTimeZone

A collection of GWTimeZone objects.

3.59.1 Properties

The following table lists properties along with their access and descriptions.

Property

Access

Description

Application

R/O

Application. The Application object.

DSTName

R/W

String. The name of this timezone when daylight savings time is in effect.

DSTOffsetFromStandard

R/W

Long. The number of minutes that daylight savings timemoves from the StandardOffsetFromGMT.

DSTYear

R/W

Integer. The specific year that the daylight savings time will apply. If zero, the month and day for the start and end of daylight savings time will be computed.

EndDSTDay

R/W

Integer. The day of the month that daylight savings timewill end. For instance, the 4th of the month.

EndDSTDayOfTheWeek

R/W

TimeZoneDaysOfWeekConstants. The day of the week during a month that daylight savings time will end. For example, the first Saturday of the month.

EndDSTMonth

R/W

TimeZoneMonthConstents. The month when daylight savings time ends. For instance, November.

EnsDSTOccurance

R/W

TimeZoneOccuranceConstants. The occurance of the day of the week during a month that daylight savings time will end. For example, the first Saturday of the month.

Parent

R/O

Account. The account object that ownes this TimeZone.

StandardName

R/W

String. The name of this time zpne when daylight savings time is not in effect.

StandardOffsetFromGMT

R/W

Long. The number of minutes tha this timezone differs from Greenwich Mean Time. For example, the Mountain Time Zone will return -420. This equates to 7 hours less than GMT.

StartDSTDay

R/W

Interger. The day of the month that daylight savings time will start. For example the 11th of the month.

StartDSTDayOfTheWeek

R/W

TimeZoneDaysOfTheWeekConstants. The day of the week that daylight savings time will start. For example, Sunday.

StartDSTMonth

R/W

TimeZoneMonthConstants. The month when daylight savings time will start. For example, March.

StartDSTOccurance

R/W

TimeZoneOccuranceConstant. The occurance of the day of the week during a month that daylight savings time starts. For example, the second Sunday of the month.

3.59.2 Methods

Commit()

Comits all chamges to the time zoneto the GroupWise account. On success, all new appointments, tasks, or notes created will contain the TimeZone information given.

3.59.3 Remarks

All dates in the GroupWise System are stored in Greenwich Mean Time (GMT). When writing dates to the database, the system converts the given date to GMT using the Time zone of the machine. When retrieving dates, the Time zone is applied in reverse.

Starting with the 6.5 version of the GroupWise Windows Client, all Group Appointments, Notes, and Tasks had the Time zone used, when the item was first created, also stored in the database.

Starting with release 8.0, the GroupWise Windows Client will store all Appointment, Notes, and Tasks with the Time zone information. Furthermore, the GroupWise Object API has been enhanced to also store the Time zone information.

For most application, the fact that a time zone is used is not important. GroupWise recommends that Third Parties not worry about this data.

If needed, the GroupWise 8.0 release of the Object API will allow a Third Party to read the time zone information used when creating these calendar items. Calling the new GWTimeZone property will return an object with all needed data.

Further, if a Third party is interfacing with a mobile device or system in another time zone, they may also set the properties of the GWTimeZone object. When the Third Party program calls the Commit method of the GWTimeZone object, all further Appointments, Notes, and Tasks created for this account will have the given Time Zone information stored in the GroupWise database.

Note: The GroupWise Object API still converts dates given using the time zone of the computer. The new GWTimeZone information is stored in the database along with the calendar item.

For more information on time zones and their data, please refer to the GetTimeZoneInformation call and the associated TIME_ZONE_INFORMATION structure in Microsoft Visual C.