> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omni.co/llms.txt
> Use this file to discover all available pages before exploring further.

# quarter_of_year

> Filters time fields by the quarter of the year.

Filters time fields by the quarter of the year. Returns rows where the date falls within the specified quarter.

## Syntax

```yaml theme={null}
<time_field>:
  quarter_of_year: "<quarter_number>"
```

## Properties

<ParamField path="time_field" type="string" required>
  The time/date field to filter on, specified in the format `view_name.field_name`.
</ParamField>

<ParamField path="quarter_of_year" type="number" required>
  The quarter to filter for:

  * `1` for Q1
  * `2` for Q2
  * `3` for Q3
  * `4` for Q4
</ParamField>

## Examples

```yaml title="Date is in Q1" theme={null}
users.created_at:
  quarter_of_year: "1"
```

```yaml title="Date is not in Q2" theme={null}
revenue.booking_date:
  not_quarter_of_year: "2"
```