119k
New

Date Picker

PreviousNext

A date picker component with range and presets.

Base UIReact AriaRadix UI
"use client"

import * as React from "react"

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

components/example-date-picker.tsx
"use client"
 
import * as React from "react"
import { getLocalTimeZone, type CalendarDate } from "@internationalized/date"
import { Calendar as CalendarIcon } from "lucide-react"
 
import { cn } from "@/lib/utils"
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
    └── Calendar

Basic

A basic date picker component.

"use client"

import * as React from "react"

Range Picker

A date picker component for selecting a range of dates.

"use client"

import * as React from "react"

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.

"use client"

import * as React from "react"

Input

A date picker component with an input field for selecting a date.

"use client"

import * as React from "react"

Time Picker

A date picker component with a time input field for selecting a time.

"use client"

import * as React from "react"

Natural Language Picker

This component uses the chrono-node library to parse natural language dates.

Your post will be published on July 19, 2026.
"use client"

import * as React from "react"

RTL

To enable RTL support in shadcn/ui, see the RTL configuration guide.

"use client"

import * as React from "react"