Search documentation
Search pages, components, blocks, styles and colours.
A date picker component with range and presets.
Installation
The Date Picker is built using a composition of the <Popover /> and the <Calendar /> components.
See installation instructions for the Popover and the Calendar components.
Usage
"use client"
import * as React from "react"
import { getLocalTimeZone, type CalendarDate } from "@internationalized/date"
import { cn } from "cn"
import { Calendar as CalendarIcon } from "lucide-react"
import { Button } from "@/components/ui/button"
import { Calendar } from "@/components/ui/calendar"
import { Popover, PopoverTrigger } from "@/components/ui/popover"
export function DatePickerDemo() {
const [date, setDate] = React.useState<CalendarDate | null>(null)
return (
<PopoverTrigger>
<Button
variant="outline"
data-empty={!date}
className="justify-start text-left font-normal data-[empty=true]:text-muted-foreground"
>
<CalendarIcon />
{date ? (
date
.toDate(getLocalTimeZone())
.toLocaleDateString(undefined, { dateStyle: "long" })
) : (
<span>Pick a date</span>
)}
</Button>
<Popover className="w-auto p-0">
<Calendar value={date} onChange={setDate} />
</Popover>
</PopoverTrigger>
)
}See the React Aria documentation for more information.
Composition
A date picker is built from Popover and Calendar (there is no DatePicker root component):
PopoverTrigger
├── Button
└── Popover
└── CalendarBasic
A basic date picker component.
Range Picker
A date picker component for selecting a range of dates.
Date of Birth
A date picker component for selecting a date of birth. This component includes a dropdown caption layout for date and month selection.
Input
A date picker component with an input field for selecting a date.
Time Picker
A date picker component with a time input field for selecting a time.
Natural Language Picker
This component uses the chrono-node library to parse natural language dates.