Skip to main content
DocsDiscover

Grain

Grain controls how date fields are truncated in queries. It's the time resolution of your results.

Available grains

GrainTruncates toExample
DayCalendar day2024-05-15
WeekMonday of the ISO week2024-05-13
MonthFirst of the month2024-05-01
QuarterFirst of the quarter2024-04-01
YearFirst of the year2024-01-01

Changing grain

Use the Grain toggle in the top bar (Day / Wk / Mo / Qtr / Yr). The query re-runs automatically.

When grain is disabled

Grain is disabled if no date field is selected in the query. Add a time field to enable grain selection.

Effect on charts

The grain affects how dates are labelled on chart axes:

  • Day → "May 15"
  • Week → "W20 '24"
  • Month → "May 2024"
  • Quarter → "Q2 2024"
  • Year → "2024"