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

# default_timeframes

> Sets the default timeframes available for date and time fields across the model.

Defines the set of timeframes available by default for every date and time field in the model. This overrides Omni's built-in default set of `raw`, `date`, `week`, `month`, `quarter`, and `year`.

Use this parameter to surface only the timeframes that matter for your use case (for example, dropping `quarter` and `year` for operational models, or adding `hour` for high-frequency event data).

Individual date or time dimensions can override this set with their own [`timeframes`](/modeling/dimensions/parameters/timeframes) parameter.

## Syntax

```yaml theme={null}
default_timeframes: [<timeframe_1>, <timeframe_2>, ...]
```

## Properties

<ParamField path="default_timeframes" type="string[]">
  An array of timeframe names to use as the default for date and time fields in the model.  The following timeframes are supported:

  | Name               | Notes                                                                  |
  | ------------------ | ---------------------------------------------------------------------- |
  | `date`             |                                                                        |
  | `day_of_month`     |                                                                        |
  | `day_of_quarter`   | Behaves as fiscal day of quarter when fiscal offset is applied         |
  | `day_of_week_name` | Sorts by `day_of_week_num`                                             |
  | `day_of_week_num`  |                                                                        |
  | `day_of_year`      |                                                                        |
  | `fiscal_quarter`   | Requires [`fiscal_month_offset`](/modeling/models/fiscal-month-offset) |
  | `fiscal_year`      | Requires [`fiscal_month_offset`](/modeling/models/fiscal-month-offset) |
  | `hour`             |                                                                        |
  | `hour_of_day`      |                                                                        |
  | `millisecond`      |                                                                        |
  | `minute`           |                                                                        |
  | `month`            |                                                                        |
  | `month_name`       | Sorts by `month_num`                                                   |
  | `month_num`        |                                                                        |
  | `quarter`          |                                                                        |
  | `quarter_of_year`  |                                                                        |
  | `raw`              |                                                                        |
  | `second`           |                                                                        |
  | `week`             |                                                                        |
  | `year`             |                                                                        |
</ParamField>

## Examples

```yaml title="Limit defaults to day, week, and month" theme={null}
default_timeframes: [date, week, month]
```

```yaml title="Include hourly and fiscal granularities by default" theme={null}
default_timeframes: [date, week, month, quarter, year, hour, fiscal_quarter, fiscal_year]
```