LocalTime property

Read-Write. A string representing a date-time in the local time zone. Additional methods let you set the local time with Date, integer, and Boolean values.

Defined in


Data type



public String getLocalTime()
   throws NotesException

public void setLocalTime(String dt)
   throws NotesException

public void setLocalTime(java.util.Date dt)
   throws NotesException

public void setLocalTime(java.util.Calendar dt)
   throws NotesException

public void setLocalDate(int year, int month, int day)
   throws NotesException

public void setLocalDate(int year, int month, int day, boolean preserveLocalTime)
   throws NotesException

public void setLocalTime(int hour, int minute, int second, int hundredth)
   throws NotesException


When you set this property, it changes the value of the date-time that the object represents, and therefore affects the GMTTime property.

The dt, year, month, day, hour, minute, second, and hundredth parameters specify the new time. The preserveLocalTime parameter affects adjustments from the existing date that cross a daylight-saving time boundary. Specify true to increment or decrement the GMT time by one hour so that a 24-hour adjustment yields the same local time in the new day. If this parameter is false or omitted, GMT time remains as adjusted and local time gains or loses an hour.

Setting this property with a java.util.Calendar object may also change the time zone.

Language cross-reference

LocalTime property in LotusScript NotesDateTime class

See Also