Description
The get-date-occurence function returns the occurence of a given date in a given month and year. It takes one required parameter, a date string in the format 'YYYY-MM-DD', and two optional parameters, inputLocale and useNearest.
Parameters
date (required): A string in the format'YYYY-MM-DD'representing the date to find the occurence of.inputLocale (optional): A string representing the language and culture to use when parsing the date string. The supported values are'pt','nl','en','de','ja','zh', and'fr'. The default value is'en'.useNearest (optional): A boolean indicating whether to return the nearest occurence of the date if it does not exist in the given month and year. The default value isfalse.
Examples
get-date-occurence("2010-12-25", inputLocale="en")
Returns: 2023-12-25 (the current year occurrence for this date)
get-date-occurence("2010-12-25", inputLocale="en", useNearest=true)
Returns: 2022-12-25 (example were made in january 2023 so the nearest occurrence is in 2022)
