Stablev0.1.0date

ROCDatePicker

民國日期選擇器

民國/西元雙曆顯示,支援日期範圍限制、今天/清除快捷鍵。

Date picker with ROC (Minguo) calendar support. Displays both ROC and Gregorian years with min/max date constraints.

Installation

CLI

npx taiwan-ui add roc-date-picker

npm package

npm install @taiwan-ui/react

Live Demo

Props API

PropTypeDefault
value*ROCDate | null
onChange*(date: ROCDate | null) => void
placeholderstring"請選擇日期"
minDateDate
maxDateDate
disabledbooleanfalse
showGregorianSubbooleantrue

Playground

Props

佔位文字

停用選擇器

顯示西元日期副標

Generated code
import ROCDatePicker from "@/components/taiwan/ROCDatePicker";

export default function Example() {
  return (
    <ROCDatePicker
  placeholder="請選擇日期"
  showGregorianSub={true}
/>
  );
}

Code Examples

import { useState } from "react";
import ROCDatePicker, { type ROCDate } from "@/components/taiwan/ROCDatePicker";

export default function MyForm() {
  const [date, setDate] = useState<ROCDate | null>(null);

  return <ROCDatePicker value={date} onChange={setDate} />;
}
民國紀年雙曆minDate/maxDatecalendar

Related Components