ymdhms-month-difference

function

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

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

Declaration

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

Purpose

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