[#BloombergLP-bbldc-BasicDayCountUtil-yearsDiff]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bbldc.adoc[bbldc]::xref:BloombergLP/bbldc/BasicDayCountUtil.adoc[BasicDayCountUtil]::yearsDiff
:relfileprefix: ../../../
:mrdocs:

Return the (signed fractional) number of years between the specified `beginDate` and `endDate` according to the specified day‐count `convention`. If `beginDate <= endDate` then the result is non‐negative. The behavior is undefined unless `isSupported(convention)`. Note that reversing the order of `beginDate` and `endDate` negates the result; specifically, `|yearsDiff(b, e, c) + yearsDiff(e, b, c)| <= 1.0e‐15` for all dates `b` and `e`, and day‐count conventions `c`.

== Synopsis

Declared in `<bbldc_basicdaycountutil.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
double
yearsDiff(
    xref:BloombergLP/bdlt/Date.adoc[bdlt::Date] const& beginDate,
    xref:BloombergLP/bdlt/Date.adoc[bdlt::Date] const& endDate,
    xref:BloombergLP/bbldc/DayCountConvention/Enum.adoc[DayCountConvention::Enum] convention);
----


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