LOTUS CONNECTORS


Compare Method for LCDatetime
This method compares two Datetime values and returns the relationship.

Defined In

LCDatetime

Syntax

Result = thisDatetime.Compare(baseDatetime)

Parameters
ParameterDescription
baseDatetimeThe Datetime to which to compare thisDatetime.

Return Value
ValueDescription
ResultLong. Result of the comparison:
Result > 0 (positive): thisDatetime is greater than baseDatetime.
Result < 0 (negative): thisDatetime is less than baseDatetime.
Result = 0: thisDatetime is equal to baseDatetime.
Certain datetime "constants" will always return greater, less or equal to any valid date. See the SetConstant method for details.

The comparison takes into account time zones and Daylight Savings time; for instance, 1:30 PM CST is considered earlier than 1:00 PM EST on the same date.

Note For control over whether time zones and Daylight Savings Time are taken into account, or to test for equality only to the nearest second (as opposed to hundredth of a second), use LCField.Compare instead.


Example

Option Public

Uselsx “*lsxlc“  

Sub Initialize

  Dim Clock As New LCDateTime (1999, 12, 31, 23, 59, 59, 99)

  Dim Match As New LCDatetime

  Match.SetCurrent

  If (Clock.Compare (Match) = 0) Then

    Print “The current time matches “ & Clock.Text

  Elseif (Clock.Compare (Match) > 0) Then

    Print “The current time is before “ & Clock.Text

  Else

    Print “The current time is after “ & Clock.Text

  End If

End Sub

Example Output
The current time is before 12/31/1999 11:59:59.99 PM