The YEARVALUE function references another line item and returns the yearly time summary in place of the detail value.

For example, you can use the YEARVALUE function to identify sales across a year that are above average.

YEARVALUE(Line item)

ArgumentData typeDescription
Line itemNumber, Boolean, date, time period, list, textThe line item to reference the yearly time summary value for.

The YEARVALUE function returns a result of the same data type as the line item you reference.

You cannot use the YEARVALUE function in a model that has the Calendar Type set to Weeks: General.

In Polaris, you cannot use the YEARVALUE function in a result line item with a time scale greater than the function.

The Classic Engine returns a value of 0 in this case.

In this example, an Income Statement module has line items on rows and Time on columns. The Net Profit line item has a numeric data type, and the Quarter above average for year line item has a Boolean data type.

In Blueprint, in the Summary column for Net ProfitTime Summary is set to Average. The formula returns a TRUE result for values that are above average for each quarter in the year.

Q1 FY21Q2 FY21Q3 FY21Q4 FY21FY21
Net Profit660,338567,656457,374446,662533,007

Quarter above average for year

Net Profit > YEARVALUE(Net Profit)