year(aDate, yearsNum)

Operator Type:

Operator Scope of Action:

Operator Purpose:

Data Type Returned:

Operator First Added:

Operator in Current Baseline:

Operator Last Altered:

Operator Has Newer Dot-Operator Variant:

Function [other Function type actions]

Item [operators of similar scope]

Date-time [other Date-time operators]

Date [about Date data type]

v5.0.0

Baseline

As at baseline

Yes

year(aDate,value)

creates a new Date based on the theDate date/time expression, but in which the year is yearsNumDate 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.

Note that the single-argument version that returns the year segment is documented separately: see year(aDate).

See also—notes linking to here:

year(aDate)