LOTUS CONNECTORS


Adjust Method for LCDatetime
This method alters a datetime by specified datetime units.

Defined In

LCDatetime

Syntax

Call changeDatetime.Adjust(Units, Amount)

Parameters
ParameterDescription
UnitsLong. The unit to adjust. Units are in the order listed in the constructor: Year, Month, Day, Hour, Minute, Second, Hundredth, Zone, DST. Use the following constants:
LCDTUNIT_YEAR -- Year units.
LCDTUNIT_MONTH -- Month units.
LCDTUNIT_DAY -- Day units.
LCDTUNIT_HOUR -- Hour units.
LCDTUNIT_MINUTE -- Minute units.
LCDTUNIT_SECOND -- Second units.
LCDTUNIT_HUNDREDTH -- Hundredth of second units.
AmountLong. The amount to adjust the datetime unit. Positive means later in time; negative means earlier.

Usage Notes

The LCDatetime.Adjust method does not support time zone adjustment. You have to do this yourself by setting the Zone property and adjusting the time by an appropriate number of hours.

LCDatetime is limited to the capabilities of time representation in relational database systems. This representation is not as rich as the NotesDateTime object and Notes datetime fields. If you need to do much math with dates and times, it is probably better to create NotesDateTime objects, which allow easier time zone conversions and control of whether Daylight Savings Time should be applied when adjusting.

Example

Option Public

Uselsx “*lsxlc“  

Sub Initialize

  Dim clock As New LCDateTime

  clock.SetCurrent

  Print “The time is “ & clock.Text

  Call clock.Adjust (LCDTUNIT_HOUR, -100)

  Print “100 hours ago, the time was “ & clock.Text

End Sub

Example Output
The time is 09/08/1998 05:22:07.18 PM

100 hours ago, the time was 09/05/1998 02:37:52.82 AM