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

# Date range picker

> Lets users select a start and end date in a single control, with locale-aware formatting and validation.

## Date range picker

<Badge color="blue">v1.0.0</Badge> | [View in Storybook](https://master--695bb4b1b8041ae09768950a.chromatic.com/?path=/docs/primitives-daterangepicker--docs)

Select a date range such as 10/06/2025 – 12/06/2025. Part of the [Date and time picker](/aura-design-system/primitives/date-and-time-picker) family; display and parsing respect the user's locale.

### When to use

* Filtering data or reports by a date window.
* Scheduling or booking flows where only dates matter (no time component).
* When comparing activity across a defined period.

### When to use something else

* Single date only: use the date picker via [Date and time picker](/aura-design-system/primitives/date-and-time-picker).
* When time boundaries matter within each day, use [Date time range picker](/aura-design-system/primitives/date-time-range-picker).
* For relative shortcuts ("Last 7 days"), consider presets alongside the picker.

### Behavior

* Enforce valid start/end ordering; show validation when the range is incomplete or inverted.
* Opening the control reveals a date picker calendar UI anchored to the field.

### Often used with

* [Label](/aura-design-system/primitives/label), [Helper text](/aura-design-system/primitives/helper-text), [Data grid](/aura-design-system/primitives/data-grid) filters.