This version is out of date, covering development from v5.0.0 to v5.12.2. It is maintained here only for inbound reference links from elsewhere.

Jump to the current version of aTbRef.

Tinderbox Icon

year(theDate[,value])


Operator Type: 

Operator Scope of Action: 

Operator Purpose: 

Operator First Added: 

Operator Altered: 

 Function   [other Function type actions]

 Item   [operators of similar scope]

 Date-time   [other Date-time operators]

 Already in v5.0.0

 


year(theDate[,value])

Alternatively, use Date.year.

year(theDate)

returns the year from the theDate date/time expression, which may simply be a date-type attribute value.

year(theDate,value)

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


Possible relevant notes (via "Similar Notes" feature):


A Tinderbox Reference File : Actions & Rules : Operators : Action Operator Scope : Item-based operators : year(theDate[,value])