# YEARPERIOD

The **YEARPERIOD** function can be used to select data from a given measure for a particular year or a range of years. It should be used in conjunction with the SELECT clause and with an aggregate function like SUM or AVERAGE. 

## Syntax

```javascript
YEARPERIOD(from_year, to_year)
```

## Arguments

from\_year – The year for which data has to be fetched or the start year if a range is specified. Required.

to\_year - The end year when a range of data has to be fetched. Optional.

## Return value

Period Range.

## Example

```javascript
YEARPERIOD(2020,2023) 
//Returns data from 2020 to 2023
YEARPERIOD(2023)
//Returns data from 2023
```

<figure><img src="/files/xOCCYZWFiVL7gtGbJxXB" alt=""><figcaption><p>YEARPERIOD without offset</p></figcaption></figure>

<figure><img src="/files/O0cS9MxRiPtuvK9pA5di" alt=""><figcaption><p>YEARPERIOD with offset</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.inforiver.com/formula-syntax/time-intelligence-functions/yearperiod.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.