DateTime :: compare - Compare timestamps

The function compares the timestamp stored in the object with the timestamp passed in the parameter.

The function returns -1 when the timestamp is lower than the timestamp passed as parameter, 1 when the the timestamp is greater than the one passed and 0, when both values are equal.

The function throws an exception, when values are invalid or not comparable.

Return value: Compare result ( int32 )

The result of a comparison is an integer value with the following meaning:

0: both operands have the same value
1: the calling operand is greater than the passed operand
-1: the calling operand is smaller than the passed operand

Implementation overview

Compare timestamp value with string timestamp
DateTime :: compare ( sDateTime )
Compare two timestamps
DateTime :: compare ( cDateTime )

Implementation details

Compare timestamp value with string timestamp
int32 DateTime :: compare ( odaba::String &sDateTime )

The function compares the timestamp value with the timestamp passed in sDateTime.
- sDateTime - DateTime value in string format
  Date time values in string format are passed as follows:
  
      date time
  
  Date and time are separated by exactly one blank character. Date has to be passed in one of following date string formats.
  
          Standard: yyyy-mm-dd or yyyymmdd
  
          English:     mm/dd/yyyy
  
          German:     dd.mm.yyyy
  
  Time has to be passed as:
  
          hh[:mm[:ss[,cc]]]
  
  Time values must not contain spaces.
  
    2009-11-19 11:23:17,43

to list

Compare two timestamps
int32 DateTime :: compare ( odaba::DateTime &cDateTime )

The function compares the date value with the date value passed in cDateTime.
- cDateTime - Time stamp
  A time stamp combines date and time

to list

to top Comment