Library: General, Date and time functions (OMDATE) Include: omdate.xin

Return type: Integer Returns:  Returns the number of seconds difference between two specified dates.

Declaration

  define integer function ymdhms-second-difference
              (value stream a, value stream b)

This function takes two date/time strings and returns the number of seconds difference between them. The two dates can be in different time zones.

Arguments:

• "a" -- the first date/time in a "YYYYMMDDhhmmss+ZHZM" format.
• "b" -- the second date/time, also in a "YYYYMMDDhhmmss+ZHZM" format.

Example:

  include "omdate.xin"
  process
     local integer elapsed-seconds
     set elapsed-seconds to ymdhms-second-difference("19980416155545+0500", "19710401080000+0000")
     output "%d(elapsed-seconds) seconds have elapsed between the specified dates/times.%n"
  ; Result of this code:
  ; 853383345 seconds have elapsed between the specified dates/times.  

Other Library Functions    add-to-ymdhms    arpadate-to-ymdhms    format-ymdhms    now-as-ymdhms    round-down-ymdhms    round-up-ymdhms    ymdhms-adjust-time-zone    ymdhms-day-difference    ymdhms-julian-day-count    ymdhms-month-difference    ymdhms-second-difference    ymdhms-to-arpadate    ymd-weekday

[ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ LEGACYLIBRARIES ] [ ERRORS ]