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

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

Declaration

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

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

Arguments:

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

Example:

  include "omdate.xin"
  process
     local integer elapsed-months
     set elapsed-months to ymdhms-month-difference ("19980416155545+0500", "19710401080000+0000")
     output "%d(elapsed-months) months have elapsed between the specified dates/times.%n"
  ; Result of this code:
  ;  324 months 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 ]