Operator Type:
Operator Scope of Action:
Operator Purpose:
Operator First Added:
Operator Last Altered:
Operator Has Optional Arguments:
Operator Has Newer Dot-Operator Variant:
Function [other Function type actions]
Item [operators of similar scope]
Date-time [other Date-time operators]
Baseline
As at baseline
[More on optional operator arguments]
Yes
year(aDate[, yearsNum])
Alternatively, use Date.year.
year(aDate)
returns the year from the theDate date/time expression:
$MyNumber = year($MyDate);
year(aDate,value)
creates a new date based on the theDate date/time expression, but in which the year is yearsNum. aDate is not changed unless theDate is an attribute and the attribute is re-setting itself:
$MyDateA = year($MyDate,2011);
$MyDate is unaltered
$MyDate = year($MyDate,2011);
$MyDate is changed
Examples. If $MyDate is July 4,2009, then
$MyDate=hour($MyDate,2011);
will change $MyDate to July 4, 2011.