Return original advanced by numYears, optionally preserving EOM.

Synopsis

Declared in <bdlt_dateutil.h>

static
Date
addYears(
    Date const& original,
    int numYears,
    bool eomFlag);

Description

Return the date that is the specified numYears from the specified original date, adjusted as necessary according to the specified eomFlag (end‐of‐month flag). If eomFlag is true and original is the last day of the month, then adjust the result to be the last day of the month; if eomFlag is false, then no such adjustment is performed. In any case, if the day of the month in original does not exist in the month of the result (e.g., February 29, 2001), move the resulting date to the last day of the month. The behavior is undefined unless the operation results in a valid Date value. Note that numYears may be negative.

Return Value

resulting date

Parameters

Name

Description

original

starting date

numYears

years to add (may be negative)

eomFlag

whether to preserve end‐of‐month when applicable

Created with MrDocs