Date Picker

A date picker component with range and presets.

Date of birth

"use client";

import * as React from "react";

import { Button } from "@smartacteam/ambient-web/button";
import { Calendar } from "@smartacteam/ambient-web/calendar";
import { CentralIcon } from "@smartacteam/ambient-web/icon";
import { Label } from "@smartacteam/ambient-web/label";
import { Popover } from "@smartacteam/ambient-web/popover";

export function DatepickerDemo() {
  const [open, setOpen] = React.useState(false);
  const [date, setDate] = React.useState<Date | undefined>(undefined);

  return (
    <div className="flex flex-col gap-3">
      <Label htmlFor="date" className="px-1">
        Date of birth
      </Label>
      <Popover.Root open={open} onOpenChange={setOpen}>
        <Popover.Trigger
          render={
            <Button id="date" className="w-48 justify-start pr-8 font-normal">
              {date ? date.toLocaleDateString() : "Select date"}
              <CentralIcon
                name="IconChevronDownSmall"
                radius="2"
                stroke="1.5"
                fill="outlined"
                className="absolute right-2 text-icon-secondary"
              />
            </Button>
          }
        />
        <Popover.Content className="w-auto overflow-hidden p-0" align="start">
          <Calendar
            mode="single"
            selected={date}
            captionLayout="dropdown"
            onSelect={(date) => {
              setDate(date);
              setOpen(false);
            }}
          />
        </Popover.Content>
      </Popover.Root>
    </div>
  );
}

Usage

The Date Picker is built using a composition of the <Popover /> and the <Calendar /> components.

"use client";
 
import * as React from "react";
 
import { Button } from "@smartacteam/ambient-web/button";
import { Calendar } from "@smartacteam/ambient-web/calendar";
import { CentralIcon } from "@smartacteam/ambient-web/icon";
import { Label } from "@smartacteam/ambient-web/label";
import { Popover } from "@smartacteam/ambient-web/popover";
 
export default function DatepickerDemo() {
  const [open, setOpen] = React.useState(false);
  const [date, setDate] = React.useState<Date | undefined>(undefined);
 
  return (
    <div className="flex flex-col gap-3">
      <Label htmlFor="date" className="px-1">
        Pick a date
      </Label>
      <Popover.Root open={open} onOpenChange={setOpen}>
        <Popover.Trigger>
          <Button id="date" className="w-48 justify-between font-normal">
            {date ? date.toLocaleDateString() : "Select date"}
            <CentralIcon
              name="IconChevronDownSmall"
              radius="2"
              stroke="1.5"
              fill="outlined"
            />
          </Button>
        </Popover.Trigger>
        <Popover.Content className="w-auto overflow-hidden p-0" align="start">
          <Calendar
            mode="single"
            selected={date}
            captionLayout="dropdown"
            onSelect={(date) => {
              setDate(date);
              setOpen(false);
            }}
          />
        </Popover.Content>
      </Popover.Root>
    </div>
  );
}

Examples

Date Range Picker

Date of birth

"use client";

import * as React from "react";

import { Button } from "@smartacteam/ambient-web/button";
import { Calendar, type DateRange } from "@smartacteam/ambient-web/calendar";
import { CentralIcon } from "@smartacteam/ambient-web/icon";
import { Label } from "@smartacteam/ambient-web/label";
import { Popover } from "@smartacteam/ambient-web/popover";

export function DatepickerRangeDemo() {
  const [open, setOpen] = React.useState(false);
  const [dateRange, setDateRange] = React.useState<DateRange | undefined>({
    from: new Date(2025, 5, 12),
    to: new Date(2025, 6, 15),
  });

  const dateText = React.useMemo(() => {
    if (!dateRange) {
      return "Select date";
    }

    if (dateRange.from && dateRange.to) {
      return `${dateRange.from.toLocaleDateString()} - ${dateRange.to.toLocaleDateString()}`;
    }

    if (dateRange.from) {
      return `${dateRange.from.toLocaleDateString()} - ...`;
    }

    if (dateRange.to) {
      return `... - ${dateRange.to.toLocaleDateString()}`;
    }

    return "Select date";
  }, [dateRange]);

  return (
    <div className="flex flex-col gap-3">
      <Label htmlFor="date" className="px-1">
        Date of birth
      </Label>
      <Popover.Root open={open} onOpenChange={setOpen}>
        <Popover.Trigger
          render={
            <Button id="date" className="w-56 justify-start pr-8 font-normal">
              {dateText}
              <CentralIcon
                name="IconChevronDownSmall"
                radius="2"
                stroke="1.5"
                fill="outlined"
                className="absolute right-2 text-icon-secondary"
              />
            </Button>
          }
        />
        <Popover.Content className="w-auto overflow-hidden p-0" align="start">
          <Calendar
            mode="range"
            captionLayout="label"
            defaultMonth={dateRange?.from}
            selected={dateRange}
            onSelect={setDateRange}
            numberOfMonths={2}
          />
        </Popover.Content>
      </Popover.Root>
    </div>
  );
}

Picker with Input

Subscription Date

"use client";

import * as React from "react";

import { Button } from "@smartacteam/ambient-web/button";
import { Calendar } from "@smartacteam/ambient-web/calendar";
import { CentralIcon } from "@smartacteam/ambient-web/icon";
import { Input } from "@smartacteam/ambient-web/input";
import { Label } from "@smartacteam/ambient-web/label";
import { Popover } from "@smartacteam/ambient-web/popover";

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

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

function isValidDate(date: Date | undefined) {
  if (!date) {
    return false;
  }
  return !isNaN(date.getTime());
}

export function CalendarInputDemo() {
  const [open, setOpen] = React.useState(false);
  const [date, setDate] = React.useState<Date | undefined>(
    new Date("2025-06-01"),
  );
  const [month, setMonth] = React.useState<Date | undefined>(date);
  const [value, setValue] = React.useState(formatDate(date));

  return (
    <div className="flex flex-col gap-3">
      <Label htmlFor="date" className="px-1">
        Subscription Date
      </Label>
      <div className="relative flex gap-2">
        <Input.Text
          id="date"
          value={value}
          className="pr-10"
          placeholder="June 01, 2025"
          onChange={(e) => {
            const date = new Date(e.target.value);
            setValue(e.target.value);
            if (isValidDate(date)) {
              setDate(date);
              setMonth(date);
            }
          }}
          onKeyDown={(e) => {
            if (e.key === "ArrowDown") {
              e.preventDefault();
              setOpen(true);
            }
          }}
        />
        <Popover.Root open={open} onOpenChange={setOpen}>
          <Popover.Trigger
            render={
              <Button
                variant="text"
                id="date-picker"
                className="absolute top-1/2 right-2 size-6 -translate-y-1/2"
              >
                <CentralIcon
                  radius="1"
                  stroke="1.5"
                  fill="outlined"
                  name="IconCalendarEdit"
                  className="size-3.5"
                />
                <span className="sr-only">Select date</span>
              </Button>
            }
          />
          <Popover.Content
            className="w-auto overflow-hidden p-0"
            align="end"
            alignOffset={-8}
            sideOffset={10}
          >
            <Calendar
              mode="single"
              selected={date}
              captionLayout="dropdown"
              month={month}
              onMonthChange={setMonth}
              onSelect={(date) => {
                setDate(date);
                setValue(formatDate(date));
                setOpen(false);
              }}
            />
          </Popover.Content>
        </Popover.Root>
      </div>
    </div>
  );
}

Picker with Pattern Input

Subscription Date

"use client";

import * as React from "react";

import { Button } from "@smartacteam/ambient-web/button";
import { Calendar } from "@smartacteam/ambient-web/calendar";
import { CentralIcon } from "@smartacteam/ambient-web/icon";
import { Input } from "@smartacteam/ambient-web/input";
import { Label } from "@smartacteam/ambient-web/label";
import { Popover } from "@smartacteam/ambient-web/popover";

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

  return `${String(date.getMonth() + 1).padStart(2, "0")}/${String(
    date.getDate(),
  ).padStart(2, "0")}/${date.getFullYear()}`;
}

function isValidDate(date: Date | undefined) {
  if (!date) {
    return false;
  }
  return !isNaN(date.getTime());
}

export function CalendarPatternDemo() {
  const [open, setOpen] = React.useState(false);
  const [date, setDate] = React.useState<Date | undefined>(
    new Date("2025-06-01"),
  );
  const [month, setMonth] = React.useState<Date | undefined>(date);
  const [value, setValue] = React.useState(formatDate(date));

  return (
    <div className="flex flex-col gap-3">
      <Label htmlFor="date" className="px-1">
        Subscription Date
      </Label>
      <div className="relative flex gap-2">
        <Input.Pattern
          id="date"
          value={value}
          format="##/##/####"
          className="pr-10"
          placeholder="MM/DD/YYYY"
          onValueChange={(e) => {
            const date = new Date(e.formattedValue);
            setValue(e.formattedValue);
            if (isValidDate(date)) {
              setDate(date);
              setMonth(date);
            }
          }}
          onKeyDown={(e) => {
            if (e.key === "ArrowDown") {
              e.preventDefault();
              setOpen(true);
            }
          }}
        />
        <Popover.Root open={open} onOpenChange={setOpen}>
          <Popover.Trigger
            render={
              <Button
                variant="text"
                id="date-picker"
                className="absolute top-1/2 right-2 size-6 -translate-y-1/2"
              >
                <CentralIcon
                  radius="1"
                  stroke="1.5"
                  fill="outlined"
                  name="IconCalendarEdit"
                  className="size-3.5"
                />
                <span className="sr-only">Select date</span>
              </Button>
            }
          />
          <Popover.Content
            className="w-auto overflow-hidden p-0"
            align="end"
            alignOffset={-8}
            sideOffset={10}
          >
            <Calendar
              mode="single"
              selected={date}
              captionLayout="dropdown"
              month={month}
              onMonthChange={setMonth}
              onSelect={(date) => {
                setDate(date);
                setValue(formatDate(date));
                setOpen(false);
              }}
            />
          </Popover.Content>
        </Popover.Root>
      </div>
    </div>
  );
}

Natural Language Picker

Schedule Date

Your post will be published on January 11, 2026.

"use client";

import { parseDate } from "chrono-node";
import * as React from "react";

import { Button } from "@smartacteam/ambient-web/button";
import { Calendar } from "@smartacteam/ambient-web/calendar";
import { CentralIcon } from "@smartacteam/ambient-web/icon";
import { Input } from "@smartacteam/ambient-web/input";
import { Label } from "@smartacteam/ambient-web/label";
import { Popover } from "@smartacteam/ambient-web/popover";

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

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

export function DatePickerNaturalLang() {
  const [open, setOpen] = React.useState(false);
  const [value, setValue] = React.useState("In 2 days");
  const [date, setDate] = React.useState<Date | undefined>(
    parseDate(value) || undefined,
  );
  const [month, setMonth] = React.useState<Date | undefined>(date);

  return (
    <div className="flex flex-col gap-3">
      <Label htmlFor="date" className="px-1">
        Schedule Date
      </Label>
      <div className="relative flex gap-2">
        <Input.Text
          id="date"
          value={value}
          placeholder="Tomorrow or next week"
          className="pr-10"
          onChange={(e) => {
            setValue(e.target.value);
            const date = parseDate(e.target.value);
            if (date) {
              setDate(date);
              setMonth(date);
            }
          }}
          onKeyDown={(e) => {
            if (e.key === "ArrowDown") {
              e.preventDefault();
              setOpen(true);
            }
          }}
        />
        <Popover.Root open={open} onOpenChange={setOpen}>
          <Popover.Trigger
            render={
              <Button
                variant="text"
                id="date-picker"
                className="absolute top-1/2 right-2 size-6 -translate-y-1/2"
              >
                <CentralIcon
                  radius="1"
                  stroke="1.5"
                  fill="outlined"
                  name="IconCalendarEdit"
                  className="size-3.5"
                />
                <span className="sr-only">Select date</span>
              </Button>
            }
          />
          <Popover.Content className="w-auto overflow-hidden p-0" align="end">
            <Calendar
              mode="single"
              selected={date}
              captionLayout="dropdown"
              month={month}
              onMonthChange={setMonth}
              onSelect={(date) => {
                setDate(date);
                setValue(formatDate(date));
                setOpen(false);
              }}
            />
          </Popover.Content>
        </Popover.Root>
      </div>
      <div className="px-1 text-sm text-foreground-secondary">
        Your post will be published on{" "}
        <span className="font-medium">{formatDate(date)}</span>.
      </div>
    </div>
  );
}