Reference > Expressions > Built-in Functions > Date Functions > LastYears

LastYears

Returns the local date and time for a date that was a certain number of years ago, based on the local time of the current session.

Syntax

LastYears(number)

Enabled for

Search/Dashboard Yes
Business Rules No
Quick Actions Yes
Workflow Objects No
Reports No

Parameter

number

The number of years to go back.

 

Note: If you enter a negative number, the function returns the local date and time for a date that is a certain number of years in the future, based on the local time of the current session.

Return Value

DateTime value.

If the system has to display the return value, it implicitly converts it to text, thereby allowing the display format to change depending on your culture code. See Available Languages and Cultures for a list of the culture codes used by HEAT.

Example

$(LastYears(3))

If today is April 10, 2014, this function returns the DateTime value for April 10, 2011.