> ## 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.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.omni.co/feedback

```json
{
  "path": "/modeling/filters/operators/month-of-year",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# month_of_year

> Filters time fields by the month of the year.

Filters time fields by the month of the year. Returns rows where the date falls in the specified month.

## Syntax

```yaml theme={null}
<time_field>:
  month_of_year: "<month_name_or_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="month_of_year" type="string" required>
  The month to filter for. The value can be either the full name of the month or a number:

  * `1` - `January`
  * `2` - `February`
  * `3` -  `March`
  * `4` -  `April`
  * `5` -  `May`
  * `6` -  `June`
  * `7` -  `July`
  * `8` -  `August`
  * `9` -  `September`
  * `10` -  `October`
  * `11` -  `November`
  * `12` -  `December`
</ParamField>

## Examples

```yaml title="Date is in January" theme={null}
users.created_at:
  month_of_year: "January"
```

```yaml title="Date is not in June" theme={null}
users.created_at:
  not_month_of_year: "6"
```