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

Return type: Integer Returns: Returns the number of days difference between two given dates.

Declaration

define integer function ymdhms-day-difference
              (value string a, value string b)

Argument definitions

a

the first date in "YYYYMMDDhhmmss+ZHZM" format

b

the second date, also in "YYYYMMDDhhmmss+ZHZM" format

This function takes two dates and returns a signed value representing the number of days difference between them. The result is rounded down to the largest number of days less than or equal to the difference. The date/times can be in different time zones.

Example:

  include "omdate.xin"
  process
     local integer elapsed-days
     set elapsed-days to ymdhms-day-difference("19980416155545+0500", "19710401080000+0000")
     output "%d(elapsed-days) days have elapsed between the specified dates/times.%n"
  ; The result of this program is:
  ;      9877 days 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 ] [ LEGACY LIBRARIES ] [ ERRORS ]