The Year function in TM1 extracts a numeric version of the year from a text string that represents a date, where the date has been presented in either YYYY-MM-DD or YY-MM-DD format. It is similar to the “extract” SQL function when combined with the “year” operator.
For example, if you have a date of ‘2017-11-28′, this function will return the number 17 (not the string ’17’).
Syntax of the YEAR Function
The syntax is:
Year ( date );
- date is the string or text version of a date in either YYYY-MM-DD or YY-MM-DD format.
An example of its use is where we have a date index that we know, let’s say the index associated with the date 9-Mar-1998, which is 13947. We then have a variable called sDate and into it we store the string date associated with that index by using the DATE function.
sDate = Date (13947 , 1); Year ( sDate);
This will return the number 98 (for 1998), which can then be used in numeric calculations.
This function can be used in Rules and Turbo Integrator processes.