Adjust Method for LCDatetime
This method alters a datetime by specified datetime units.
Defined In
LCDatetime
Syntax
Call changeDatetime.Adjust (Units, Amount)
Parameters
| Parameter |
Description |
|---|---|
| Units |
Long. 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. |
|
| Amount |
Long. 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 SubExample 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