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

Return the date in the specified `month` of the specified `year` corresponding to the specified `n`th occurrence of the specified `dayOfWeek`. If `n < 0`, return the date corresponding to the `‐n`th occurrence of the `dayOfWeek` counting from the end of the `month` towards the first of the `month`. If `5 == n` and a result cannot be found in `month`, then return the date of the first `dayOfWeek` in the following month. If `‐5 == n` and a result cannot be found in `month`, then return the date of the last `dayOfWeek` in the previous month. The behavior is undefined unless `1 <= year <= 9999`, `1 <= month <= 12`, `n != 0`, `‐5 <= n <= 5`, and the resulting date is neither earlier than 0001/01/01 nor later than 9999/12/31.

== Synopsis

Declared in `<bdlt_dateutil.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
xref:BloombergLP/bdlt/Date.adoc[Date]
nthDayOfWeekInMonth(
    int year,
    int month,
    xref:BloombergLP/bdlt/DayOfWeek/Enum.adoc[DayOfWeek::Enum] dayOfWeek,
    int n);
----

== Description

For example: ` nthDayOfWeekInMonth(2004, 11, DayOfWeek::e_THURSDAY, 4); ` returns November 25, 2004, the fourth Thursday in November, 2004.


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