convertToZone (DateTime - Java)

Changes the TimeZone and IsDST properties as specified.

Defined in



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


int zone

A time zone -12 through 12.

boolean isDST

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.