# TOTALYTD

The TOTALYTD function evaluates the year-to-date value of the measure in the current context. It should be used in conjunction with an aggregate function like SUM or AVERAGE.&#x20;

## Syntax

```javascript
TOTALYTD([measure])
// Returns the year-to-date value of the measure for every year
```

## Arguments

measure – The measure for which data has to be fetched and aggregated. Required.

## Return Value

Range of data. When used with an aggregation function, it returns a scalar value running-calculated to date, according to the period selected.

## Example

Find below an example where the discount measure is calculated year-to-date.&#x20;

<figure><img src="https://3062809325-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEbkCXCUXmtUq5tcnUtZE%2Fuploads%2FwlJtY41x5SsWqlBJGQ9J%2Fimage.png?alt=media&#x26;token=ed047a9c-d5d8-4929-8ac1-822505008dde" alt=""><figcaption><p>TOTALYTD</p></figcaption></figure>
