Skip to content
WebJs
Menu

Date Picker

A date picker component with range and presets.

import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import { buttonClass } from '#components/ui/button.ts';
import { popoverContentClass } from '#components/ui/popover.ts';
import { ChevronDownIcon } from '#lib/ui/lucide.ts';

export default function DatePickerDemo() {
  return html`
    <button type="button" popovertarget="date-picker-demo" aria-haspopup="dialog" aria-expanded="false" data-empty="true" data-slot="button" data-variant="outline" data-size="default" class=${cn(buttonClass({ variant: 'outline' }), 'w-[212px] justify-between text-left font-normal data-[empty=true]:text-muted-foreground')}>
      <span>Pick a date</span>
      ${ChevronDownIcon()}
    </button>
    <div id="date-picker-demo" popover role="dialog" aria-label="Pick a date" data-slot="popover-content" class=${cn(popoverContentClass({ align: 'start' }), 'w-auto p-0')}>
      <ui-calendar mode="single"></ui-calendar>
    </div>
  `;
}
View Code

Installation

The Date Picker is built using a composition of the popover attribute and the <ui-calendar> component.

See installation instructions for the Popover and the Calendar components.

Usage

components/example-date-picker.ts
import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import { buttonClass } from '#components/ui/button.ts';
import { popoverContentClass } from '#components/ui/popover.ts';
import '#components/ui/calendar.ts';
import { CalendarIcon } from '#lib/ui/lucide.ts';

export function DatePickerDemo() {
  return html`
    <button
      type="button"
      popovertarget="date-picker"
      aria-haspopup="dialog"
      aria-expanded="false"
      data-empty="true"
      class=${cn(buttonClass({ variant: 'outline' }), 'w-[280px] justify-start text-left font-normal data-[empty=true]:text-muted-foreground')}
    >
      ${CalendarIcon()}
      <span>Pick a date</span>
    </button>
    <div id="date-picker" popover role="dialog" aria-label="Pick a date" class=${cn(popoverContentClass(), 'w-auto p-0')}>
      <ui-calendar mode="single" name="date"></ui-calendar>
    </div>
  `;
}

The calendar dispatches ui-value-change with the picked date in detail.value (a "YYYY-MM-DD" string), so a component that wants the trigger to show the date listens for it and re-renders the label. With name, the date also submits with the surrounding form. See the Calendar documentation for more information.

Composition

A date picker is built from a popover and <ui-calendar>:

button[popovertarget]
div[popover]  popoverContentClass()
└── ui-calendar

Basic

A basic date picker component.

import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import { buttonClass } from '#components/ui/button.ts';
import { fieldClass, fieldLabelClass } from '#components/ui/field.ts';
import { popoverContentClass } from '#components/ui/popover.ts';

export default function DatePickerBasic() {
  return html`
    <div role="group" data-slot="field" data-orientation="vertical" class=${cn(fieldClass(), 'mx-auto w-44')}>
      <label data-slot="field-label" for="date-picker-simple" class=${fieldLabelClass()}>Date</label>
      <button
        type="button"
        id="date-picker-simple"
        popovertarget="date-picker-simple-content"
        aria-haspopup="dialog"
        aria-expanded="false"
        data-slot="button"
        data-variant="outline"
        data-size="default"
        class=${cn(buttonClass({ variant: 'outline' }), 'justify-start font-normal')}
      >
        <span>Pick a date</span>
      </button>
      <div id="date-picker-simple-content" popover role="dialog" aria-label="Pick a date" data-slot="popover-content" class=${cn(popoverContentClass({ align: 'start' }), 'w-auto p-0')}>
        <ui-calendar mode="single"></ui-calendar>
      </div>
    </div>
  `;
}
View Code

Range Picker

A date picker component for selecting a range of dates.

import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import { buttonClass } from '#components/ui/button.ts';
import { fieldClass, fieldLabelClass } from '#components/ui/field.ts';
import { popoverContentClass } from '#components/ui/popover.ts';
import { CalendarIcon } from '#lib/ui/lucide.ts';

const iso = (d: Date) => d.toISOString().slice(0, 10);
const label = (d: Date) =>
  d.toLocaleDateString('en-US', { month: 'short', day: '2-digit', year: 'numeric', timeZone: 'UTC' });

// January 20 to February 9 of this year, as shadcn's demo starts.
export default function DatePickerRange() {
  const year = new Date().getFullYear();
  const from = new Date(Date.UTC(year, 0, 20));
  const to = new Date(Date.UTC(year, 0, 20 + 20));

  return html`
    <div role="group" data-slot="field" data-orientation="vertical" class=${cn(fieldClass(), 'mx-auto w-60')}>
      <label data-slot="field-label" for="date-picker-range" class=${fieldLabelClass()}>Date Picker Range</label>
      <button
        type="button"
        id="date-picker-range"
        popovertarget="date-picker-range-content"
        aria-haspopup="dialog"
        aria-expanded="false"
        data-slot="button"
        data-variant="outline"
        data-size="default"
        class=${cn(buttonClass({ variant: 'outline' }), 'justify-start px-2.5 font-normal')}
      >
        ${CalendarIcon()}
        ${[label(from), label(to)].join(' - ')}
      </button>
      <div id="date-picker-range-content" popover role="dialog" aria-label="Pick a date range" data-slot="popover-content" class=${cn(popoverContentClass({ align: 'start' }), 'w-auto p-0')}>
        <ui-calendar mode="range" value=${`${iso(from)}/${iso(to)}`} month=${iso(from).slice(0, 7)} number-of-months="2"></ui-calendar>
      </div>
    </div>
  `;
}
View Code

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.

import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import { buttonClass } from '#components/ui/button.ts';
import { fieldClass, fieldLabelClass } from '#components/ui/field.ts';
import { popoverContentClass } from '#components/ui/popover.ts';

export default function DatePickerDob() {
  return html`
    <div role="group" data-slot="field" data-orientation="vertical" class=${cn(fieldClass(), 'mx-auto w-44')}>
      <label data-slot="field-label" for="date" class=${fieldLabelClass()}>Date of birth</label>
      <button
        type="button"
        id="date"
        popovertarget="date-picker-dob-content"
        aria-haspopup="dialog"
        aria-expanded="false"
        data-slot="button"
        data-variant="outline"
        data-size="default"
        class=${cn(buttonClass({ variant: 'outline' }), 'justify-start font-normal')}
      >
        Select date
      </button>
      <div id="date-picker-dob-content" popover role="dialog" aria-label="Date of birth" data-slot="popover-content" class=${cn(popoverContentClass({ align: 'start' }), 'w-auto overflow-hidden p-0')}>
        <ui-calendar mode="single" caption-layout="dropdown"></ui-calendar>
      </div>
    </div>
  `;
}
View Code

Input

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

import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import { fieldClass, fieldLabelClass } from '#components/ui/field.ts';
import {
  inputGroupClass, inputGroupAddonClass, inputGroupButtonClass, inputGroupInputClass,
} from '#components/ui/input-group.ts';
import { popoverContentClass } from '#components/ui/popover.ts';
import { CalendarIcon } from '#lib/ui/lucide.ts';

function formatDate(date: Date | undefined) {
  if (!date) {
    return '';
  }

  return date.toLocaleDateString('en-US', {
    day: '2-digit',
    month: 'long',
    year: 'numeric',
    timeZone: 'UTC',
  });
}

export default function DatePickerInput() {
  const date = new Date('2025-06-01');

  return html`
    <div role="group" data-slot="field" data-orientation="vertical" class=${cn(fieldClass(), 'mx-auto w-48')}>
      <label data-slot="field-label" for="date-required" class=${fieldLabelClass()}>Subscription Date</label>
      <div data-slot="input-group" role="group" class=${inputGroupClass()}>
        <input
          data-slot="input-group-control"
          id="date-required"
          value=${formatDate(date)}
          placeholder="June 01, 2025"
          class=${inputGroupInputClass()}
        >
        <div role="group" data-slot="input-group-addon" data-align="inline-end" class=${inputGroupAddonClass({ align: 'inline-end' })}>
          <button
            type="button"
            id="date-picker"
            popovertarget="date-picker-input-content"
            aria-haspopup="dialog"
            aria-expanded="false"
            aria-label="Select date"
            data-slot="button"
            data-variant="ghost"
            data-size="icon-xs"
            class=${inputGroupButtonClass({ size: 'icon-xs', variant: 'ghost' })}
          >
            ${CalendarIcon()}
            <span class="sr-only">Select date</span>
          </button>
          <div id="date-picker-input-content" popover role="dialog" aria-label="Select date" data-slot="popover-content" class=${cn(popoverContentClass({ align: 'end', sideOffset: 8 }), 'w-auto overflow-hidden p-0')}>
            <ui-calendar mode="single" value="2025-06-01" month="2025-06"></ui-calendar>
          </div>
        </div>
      </div>
    </div>
  `;
}
View Code

Time Picker

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

import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import { buttonClass } from '#components/ui/button.ts';
import { fieldGroupClass, fieldClass, fieldLabelClass } from '#components/ui/field.ts';
import { inputClass } from '#components/ui/input.ts';
import { popoverContentClass } from '#components/ui/popover.ts';
import { ChevronDownIcon } from '#lib/ui/lucide.ts';

export default function DatePickerTime() {
  return html`
    <div data-slot="field-group" class=${cn(fieldGroupClass(), 'mx-auto max-w-xs flex-row')}>
      <div role="group" data-slot="field" data-orientation="vertical" class=${fieldClass()}>
        <label data-slot="field-label" for="date-picker-optional" class=${fieldLabelClass()}>Date</label>
        <button
          type="button"
          id="date-picker-optional"
          popovertarget="date-picker-time-content"
          aria-haspopup="dialog"
          aria-expanded="false"
          data-slot="button"
          data-variant="outline"
          data-size="default"
          class=${cn(buttonClass({ variant: 'outline' }), 'w-32 justify-between font-normal')}
        >
          Select date
          ${ChevronDownIcon()}
        </button>
        <div id="date-picker-time-content" popover role="dialog" aria-label="Select date" data-slot="popover-content" class=${cn(popoverContentClass({ align: 'start' }), 'w-auto overflow-hidden p-0')}>
          <ui-calendar mode="single" caption-layout="dropdown"></ui-calendar>
        </div>
      </div>
      <div role="group" data-slot="field" data-orientation="vertical" class=${cn(fieldClass(), 'w-32')}>
        <label data-slot="field-label" for="time-picker-optional" class=${fieldLabelClass()}>Time</label>
        <input
          data-slot="input"
          type="time"
          id="time-picker-optional"
          step="1"
          value="10:30:00"
          class=${cn(inputClass(), 'appearance-none bg-background [&::-webkit-calendar-picker-indicator]:hidden [&::-webkit-calendar-picker-indicator]:appearance-none')}
        >
      </div>
    </div>
  `;
}
View Code

Natural Language Picker

A natural language picker turns text such as "In 2 days" into a date. Parse what the reader types with a library of your choice. The demo shows the first paint for "In 2 days".

Your post will be published on November 22, 2026.
import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import { fieldClass, fieldLabelClass } from '#components/ui/field.ts';
import {
  inputGroupClass, inputGroupAddonClass, inputGroupButtonClass, inputGroupInputClass,
} from '#components/ui/input-group.ts';
import { popoverContentClass } from '#components/ui/popover.ts';
import { CalendarIcon } from '#lib/ui/lucide.ts';

function formatDate(date: Date | undefined) {
  if (!date) {
    return '';
  }

  return date.toLocaleDateString('en-US', {
    day: '2-digit',
    month: 'long',
    year: 'numeric',
  });
}

// shadcn parses the text with chrono-node. The kit ships no parser, so this
// shows the first paint for "In 2 days": the date it resolves to, worked out
// here. Parsing what the reader types is yours to add (any date library).
export default function DatePickerNaturalLanguage() {
  const value = 'In 2 days';
  const date = new Date();
  date.setDate(date.getDate() + 2);
  const iso = `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, '0')}-${String(date.getDate()).padStart(2, '0')}`;

  return html`
    <div role="group" data-slot="field" data-orientation="vertical" class=${cn(fieldClass(), 'mx-auto max-w-xs')}>
      <label data-slot="field-label" for="date-optional" class=${fieldLabelClass()}>Schedule Date</label>
      <div data-slot="input-group" role="group" class=${inputGroupClass()}>
        <input
          data-slot="input-group-control"
          id="date-optional"
          value=${value}
          placeholder="Tomorrow or next week"
          class=${inputGroupInputClass()}
        >
        <div role="group" data-slot="input-group-addon" data-align="inline-end" class=${inputGroupAddonClass({ align: 'inline-end' })}>
          <button
            type="button"
            id="date-picker-natural"
            popovertarget="date-picker-natural-content"
            aria-haspopup="dialog"
            aria-expanded="false"
            aria-label="Select date"
            data-slot="button"
            data-variant="ghost"
            data-size="icon-xs"
            class=${inputGroupButtonClass({ size: 'icon-xs', variant: 'ghost' })}
          >
            ${CalendarIcon()}
            <span class="sr-only">Select date</span>
          </button>
          <div id="date-picker-natural-content" popover role="dialog" aria-label="Select date" data-slot="popover-content" class=${cn(popoverContentClass({ align: 'end', sideOffset: 8 }), 'w-auto overflow-hidden p-0')}>
            <ui-calendar mode="single" caption-layout="dropdown" value=${iso} month=${iso.slice(0, 7)}></ui-calendar>
          </div>
        </div>
      </div>
      <div class="px-1 text-sm text-muted-foreground">
        Your post will be published on
        <span class="font-medium">${formatDate(date)}</span>.
      </div>
    </div>
  `;
}
View Code

RTL

To enable RTL support, see the RTL configuration guide.

import { html } from '@webjsdev/core';
import { cn } from '#lib/utils/cn.ts';
import { buttonClass } from '#components/ui/button.ts';
import { popoverContentClass } from '#components/ui/popover.ts';
import { ChevronDownIcon } from '#lib/ui/lucide.ts';

const translations = {
  en: { dir: 'ltr', values: { placeholder: 'Pick a date' } },
  ar: { dir: 'rtl', values: { placeholder: 'اختر تاريخًا' } },
  he: { dir: 'rtl', values: { placeholder: 'בחר תאריך' } },
};

// The calendar names its months and days through Intl in the given locale,
// and dir="rtl" flips the grid, the arrow keys and the navigation buttons.
export default function DatePickerRtl() {
  const language = 'ar';
  const { dir, values: t } = translations[language];

  return html`
    <button
      type="button"
      popovertarget="date-picker-rtl"
      aria-haspopup="dialog"
      aria-expanded="false"
      data-empty="true"
      dir=${dir}
      data-slot="button"
      data-variant="outline"
      data-size="default"
      class=${cn(buttonClass({ variant: 'outline' }), 'w-[212px] justify-between text-left font-normal data-[empty=true]:text-muted-foreground')}
    >
      <span>${t.placeholder}</span>
      ${ChevronDownIcon()}
    </button>
    <div id="date-picker-rtl" popover role="dialog" aria-label=${t.placeholder} dir=${dir} data-slot="popover-content" class=${cn(popoverContentClass({ align: 'start' }), 'w-auto p-0')}>
      <ui-calendar mode="single" locale=${language} dir=${dir}></ui-calendar>
    </div>
  `;
}
View Code