LocalTime (DateTime - Java™)

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

DateTime

Data type

String

Syntax

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

Note: This signature is new with Release 6.

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

Usage

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.

Example