AddMonths
Returns a date-time value that is the number of months prior to or after the specified date-time value.
- Returned Output: Date-Time
- Library: PQL \ Common \ Date-Time
- Version: 2018.00.000
- Compatibility:
- Can be combined with and other PQL function throughout the application.
- It CANNOT be used with MDX or VBA functions. But it can be used on MDX-based content in other parts of the application.
Syntax
AddMonths( <Date-Time> , <Month Integer> )
* Click on the function's arguments above for more details on the input values.
Comments
- The date time value can be any element that resolves to a date-time value.
- Use a positive month integer to count months forward from the given date, in order to return a date after the given date.
- Use negative month integers to return a specified date prior to the given date.
Different Function types
- To use a AddMonths date-time operation on a date-time member, use the Semantic library function.
Examples
This example subtracts 2 months from the current date "2019-Apr-08 14:35:00.2" - returning February 8 2019
AddMonths( dateTime(), -2 )
If the figure had been set to "2" the result would have been 2019-06-08 instead.