Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


UI Text Box
sizemedium
typeinfo

This function returns the year part of a timestamp based on a given time zone


Code Block
languagebash
titleSyntax
linenumberstrue
year(timestamp, timeZone) #Output: Number


UI Expand
titleExamples


Parser expressionDescription


Code Block
languagebash
linenumberstrue
year({issue.dueDate}, LOCAL)


This example returns the year part of the issue due date. 

UI Text Box
typeinfo

If the due date was set to March 25th, 2020 the output will be 2020.




UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
timestamp

Status
subtletrue
titlenumber

The parameter must be valid timestamp. Usually this value is retrieved from a field (e.g. due date, created date).
timeZone

Status
subtletrue
titletext

The time zone used for the calculation. 


UI Text Box
typetip

Work days might depend on the time zone - it might be Dec 31st on the west coast of the US while at the same time it's already Monday Jan 1st in Australia. 



UI Expand
titleOutput

This function returns a

Status
subtletrue
titlenumber



Use cases and examples

Page properties report
firstcolumnUse case
headingsJWT feature, Workflow function, Field type, Automated action, Parser functions
cqllabel = "parser_func_year" and space = currentSpace()


Page properties
hiddentrue



Status
Tech review

Status
colourGreen
titledone

Style guide

Status
colourGreen
titledone

Status
titletodo
Status
colourYellow
titleReady for review
Status
colourGreen
titledone
Status
colourRed
titleflagged



Page properties
hiddentrue


Short description

Returns the year part of a timestamp.

Output

Status
subtletrue
titlenumber

Label