# MONTHPERIOD

The **MONTHPERIOD** function can be used to select data from a given measure for a particular month or a range of months. It should be used in conjunction with the SELECT clause and with an aggregate function like SUM or AVERAGE.&#x20;

## Syntax

```javascript
MONTHPERIOD(year, from_month, to_month)
```

## Arguments

year – The year for which data has to be fetched. Required.

from\_month – The month for which data has to be fetched or the start month if a range is specified. Values can be between 1 and 12. Required.

to\_month - The end month when a range of data has to be fetched. Values can be between 1 and 12. Optional.

## Return value

Period Range.

## Example

```javascript
MONTHPERIOD(2024,1,4) 
//Returns data from January to April of 2024
MONTHPERIOD(2025,5)
//Returns data from May, 2025
```

<figure><img src="https://3062809325-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEbkCXCUXmtUq5tcnUtZE%2Fuploads%2FJG9qT8OFzkWr0zkqmEcQ%2Fimage.png?alt=media&#x26;token=f37f3d07-d399-4dd8-afdd-91ff932579a4" alt=""><figcaption><p>MONTHPERIOD without offset</p></figcaption></figure>

<figure><img src="https://3062809325-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEbkCXCUXmtUq5tcnUtZE%2Fuploads%2FwKpqT6ERVB4Ehe1ODnZI%2Fimage.png?alt=media&#x26;token=224d1e72-03ad-4ad4-91ba-e5b847494294" alt=""><figcaption><p>MONTHPERIOD with offset</p></figcaption></figure>
