This version is out of date, covering development from v7.0.0 to v7.5.6. It is maintained here only for inbound reference links from elsewhere. It is no longer actively updated.

Jump to the current version of aTbRef

Tinderbox 7 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]

 Baseline

 


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.