Changes the TimeZone and IsDST properties as specified.

Defined in

DateTime

Syntax

public void convertToZone(int zone, boolean isDST)
   throws NotesException

Parameters

int zone

A time zone -12 through 12.

Indicates whether daylight-saving time is in effect (true) or not (false).

These changes also affect the ZoneTime property.

These changes do not affect the GMTTime and the LocalTime properties.

This method has no effect on an invalid TimeZone (because the DateTime object lacks the date or the time). TimeZone continues to return 0.

Caution This method uses the daylight saving time rules of the zone being converted from, not the zone being converted to.

Daylight saving time is a world-wide practice of decreasing energy consumption by adjusting clocks forward an hour, changing the offset from GMT. The TimeZone property indicates the base offset from GMT. For example, standard time in New York City is GMT -5, but when daylight savings is in effect, New York City is GMT -4.

Language cross-reference

ConvertToZone method in LotusScript NotesDateTime class

Example
See Also

Working with time

Glossary