[#BloombergLP-bdlt-DateUtil-addYearsEom]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlt.adoc[bdlt]::xref:BloombergLP/bdlt/DateUtil.adoc[DateUtil]::addYearsEom
:relfileprefix: ../../../
:mrdocs:

Return `original` advanced by `numYears` with end‐of‐month rules.

== Synopsis

Declared in `<bdlt_dateutil.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
xref:BloombergLP/bdlt/Date.adoc[Date]
addYearsEom(
    xref:BloombergLP/bdlt/Date.adoc[Date] const& original,
    int numYears);
----

== Description

Return the date that is the specified `numYears` from the specified `original` date, adjusted as necessary according to the following (end‐of‐month) rules: (1) if `original` is the last day of a month, adjust the result to be the last day of the month, and (2) 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

[cols="1,4"]
|===
| Name| Description
| *original*
| starting date
| *numYears*
| years to add (may be negative)
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#