DatePicker
DatePicker captures single dates and related date-picker states with typed callbacks.
@duskmoon-dev/components/date-pickerUsage
When to use
- Use it inside forms, filters, settings, and any workflow that captures user input.
- Prefer controlled props when the value must stay synchronized with application state.
Implementation notes
Features
Documents default values, value props, and change callbacks for form integration.
Surfaces status, size, disabled, and option data patterns where the component supports them.
DatePicker is most often configured through `inputProps`, `value`, `defaultValue`, `onChange`.
Renders one complete decorative calendar SVG inside the accessible dropdown trigger
Feature Demos
Feature demos are authored for the component page, then supplemented with behavior scenarios from the component test coverage.
Basic usage
Import the component stylesheet and DatePicker from its package subpath, then render it with the core props.
Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";
export function Example() {
return (<DatePicker
defaultValue="2026-05-25"
size="lg"
status="success"
onChange={(value) => console.log(value)}
/>);
}Renders one complete decorative calendar SVG inside the accessible dropdown trigger
test-backedDatePicker scenario from the component test coverage: renders one complete decorative calendar svg inside the accessible dropdown trigger.
Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";
export function DatePickerRendersOneCompleteDecorativeDemo() {
return (<DatePicker
defaultValue="2026-05-25"
size="lg"
status="success"
onChange={(value) => console.log(value)}
/>);
}Year drilldown preserves controlled value and open state
test-backedDatePicker scenario from the component test coverage: year drilldown preserves controlled value and open state.
Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";
export function DatePickerYearDrilldownPreservesControlledDemo() {
return (<DatePicker
defaultValue="2026-05-25"
size="lg"
status="success"
onChange={(value) => console.log(value)}
/>);
}Browses year and month without committing until an enabled day is selected
test-backedDatePicker scenario from the component test coverage: browses year and month without committing until an enabled day is selected.
Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";
export function DatePickerBrowsesYearAndMonthDemo() {
return (<DatePicker
defaultValue="2026-05-25"
size="lg"
status="success"
onChange={(value) => console.log(value)}
/>);
}Month picker still commits a month string and closes
test-backedDatePicker scenario from the component test coverage: month picker still commits a month string and closes.
Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";
export function DatePickerMonthPickerStillCommitsDemo() {
return (<DatePicker
defaultValue="2026-05-25"
size="lg"
status="success"
onChange={(value) => console.log(value)}
/>);
}Opens a default calendar by icon or input and commits an enabled date
test-backedDatePicker scenario from the component test coverage: opens a default calendar by icon or input and commits an enabled date.
Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";
export function DatePickerOpensADefaultCalendarDemo() {
return (<DatePicker
defaultValue="2026-05-25"
size="lg"
status="success"
onChange={(value) => console.log(value)}
/>);
}Honors controlled open and disabled states
test-backedDatePicker scenario from the component test coverage: honors controlled open and disabled states.
Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";
export function DatePickerHonorsControlledOpenAndDemo() {
return (<DatePicker
defaultValue="2026-05-25"
size="lg"
status="success"
onChange={(value) => console.log(value)}
/>);
}Renders picker input with value, size, status, and classes
test-backedDatePicker scenario from the component test coverage: renders picker input with value, size, status, and classes.
Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";
export function DatePickerRendersPickerInputWithDemo() {
return (<DatePicker
defaultValue="2026-05-25"
size="lg"
status="success"
onChange={(value) => console.log(value)}
/>);
}Supports uncontrolled changes and clear
test-backedDatePicker scenario from the component test coverage: supports uncontrolled changes and clear.
Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";
export function DatePickerSupportsUncontrolledChangesAndDemo() {
return (<DatePicker
defaultValue="2026-05-25"
size="lg"
status="success"
onChange={(value) => console.log(value)}
/>);
}Supports presets and showNow
test-backedDatePicker scenario from the component test coverage: supports presets and shownow.
Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";
export function DatePickerSupportsPresetsAndShowNowDemo() {
return (<DatePicker
defaultValue="2026-05-25"
size="lg"
status="success"
onChange={(value) => console.log(value)}
/>);
}Blocks disabledDate values
test-backedDatePicker scenario from the component test coverage: blocks disableddate values.
Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";
export function DatePickerBlocksDisabledDateValuesDemo() {
return (<DatePicker
defaultValue="2026-05-25"
size="lg"
status="success"
onChange={(value) => console.log(value)}
/>);
}Supports range picker values
test-backedDatePicker scenario from the component test coverage: supports range picker values.
Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";
export function DatePickerSupportsRangePickerValuesDemo() {
return (<DatePicker
defaultValue="2026-05-25"
size="lg"
status="success"
onChange={(value) => console.log(value)}
/>);
}Exposes static picker aliases
test-backedDatePicker scenario from the component test coverage: exposes static picker aliases.
Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";
export function DatePickerExposesStaticPickerAliasesDemo() {
return (<DatePicker
defaultValue="2026-05-25"
size="lg"
status="success"
onChange={(value) => console.log(value)}
/>);
}Forwards native input labels and errors without overriding controlled behavior
test-backedDatePicker scenario from the component test coverage: forwards native input labels and errors without overriding controlled behavior.
Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";
export function DatePickerForwardsNativeInputLabelsDemo() {
return (<DatePicker
defaultValue="2026-05-25"
size="lg"
status="success"
onChange={(value) => console.log(value)}
/>);
}Range inputs inherit attributes with distinct native ids
test-backedDatePicker scenario from the component test coverage: range inputs inherit attributes with distinct native ids.
Source
import "@duskmoon-dev/components/styles.css";
import { DatePicker } from "@duskmoon-dev/components/date-picker";
export function DatePickerRangeInputsInheritAttributesDemo() {
return (<DatePicker
defaultValue="2026-05-25"
size="lg"
status="success"
onChange={(value) => console.log(value)}
/>);
}Theme aware
Docs previews inherit the DuskMoon data-theme value. Use the header switch to compare light and dark rendering.
Source
<div data-theme="sunshine">
<DatePicker
defaultValue="2026-05-25"
size="lg"
status="success"
onChange={(value) => console.log(value)}
/>
</div>
<div data-theme="moonlight">
<DatePicker
defaultValue="2026-05-25"
size="lg"
status="success"
onChange={(value) => console.log(value)}
/>
</div>API
The API reference below lists every parsed exported type or interface for DatePicker. Start with `inputProps`, `value`, `defaultValue`, `onChange` for common usage.
packages/components/src/components/date-picker/DatePicker.types.tsScenarios: packages/components/src/components/date-picker/DatePicker.test.tsx| Prop | Type | Required | Description |
|---|---|---|---|
inputProps | ComponentProps<"input"> | No | inputProps configures DatePicker. |
value | DatePickerValue | No | value configures DatePicker. |
defaultValue | DatePickerValue | No | defaultValue configures DatePicker. |
onChange | (value: DatePickerValue | undefined, dateString: string) => void | No | onChange configures DatePicker. |
onBlur | (event: DatePickerInputFocusEvent) => void | No | onBlur configures DatePicker. |
onFocus | (event: DatePickerInputFocusEvent) => void | No | onFocus configures DatePicker. |
onOpenChange | (open: boolean) => void | No | onOpenChange configures DatePicker. |
picker | DatePickerPicker | No | picker configures DatePicker. |
format | string | No | format configures DatePicker. |
placeholder | string | No | placeholder configures DatePicker. |
disabled | boolean | No | disabled configures DatePicker. |
disabledDate | (value: DatePickerValue) => boolean | No | disabledDate configures DatePicker. |
presets | DatePickerPreset[] | No | presets configures DatePicker. |
showNow | boolean | No | showNow configures DatePicker. |
allowClear | boolean | No | allowClear configures DatePicker. |
open | boolean | No | open configures DatePicker. |
defaultOpen | boolean | No | defaultOpen configures DatePicker. |
size | DatePickerSize | No | size configures DatePicker. |
status | DatePickerStatus | No | status configures DatePicker. |
| Prop | Type | Required | Description |
|---|---|---|---|
label | ReactNode | Yes | label configures DatePicker. |
value | DatePickerValue | Yes | value configures DatePicker. |
| Prop | Type | Required | Description |
|---|---|---|---|
value | DatePickerRangeValue | No | value configures DatePicker. |
defaultValue | DatePickerRangeValue | No | defaultValue configures DatePicker. |
onChange | ( | No | onChange configures DatePicker. |
value | DatePickerRangeValue, | Yes | value configures DatePicker. |
dateStrings | [string, string], | Yes | dateStrings configures DatePicker. |
placeholder | [string, string] | No | placeholder configures DatePicker. |
separator | ReactNode | No | separator configures DatePicker. |
| Prop | Type | Required | Description |
|---|---|---|---|
RangePicker | ForwardRefExoticComponent< | Yes | RangePicker configures DatePicker. |
WeekPicker | ForwardRefExoticComponent< | Yes | WeekPicker configures DatePicker. |
MonthPicker | ForwardRefExoticComponent< | Yes | MonthPicker configures DatePicker. |
QuarterPicker | ForwardRefExoticComponent< | Yes | QuarterPicker configures DatePicker. |
YearPicker | ForwardRefExoticComponent< | Yes | YearPicker configures DatePicker. |
Type definition
stringType definition
[ DatePickerValue | undefined, DatePickerValue | undefined, ]Type definition
"date" | "week" | "month" | "quarter" | "year" | "time"Type definition
"sm" | "md" | "lg"Type definition
"error" | "success"Type definition
ChangeEvent<HTMLInputElement>Type definition
FocusEvent<HTMLInputElement>