Stablev0.1.0date

ROCDateRangePicker

民國日期範圍選擇器

民國紀年日期範圍選擇器,自動驗證起訖日期順序、計算總天數,由兩個 ROCDatePicker 組合而成。

ROC (民國) date range picker — composes two ROCDatePickers with cross-field validation so the end date cannot be before the start. Auto-calculates the day count.

Installation

CLI

npx taiwan-ui add roc-date-range-picker

npm package

npm install @taiwan-ui/react

Requires: components/taiwan/ROCDatePicker

Live Demo

Props API

PropTypeDefault
value*ROCDateRange
onChange*(range: ROCDateRange) => void
minDateDate
maxDateDate
startPlaceholderstring"起始日期"
endPlaceholderstring"結束日期"
disabledbooleanfalse
showGregorianSubbooleantrue
separatorReact.ReactNode"→"

Playground

Props

起始日佔位

結束日佔位

停用全部

顯示西元副標

Non-editable type — edit in code.

中間分隔符

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

export default function Example() {
  return (
    <ROCDateRangePicker
  startPlaceholder="起始日期"
  endPlaceholder="結束日期"
  showGregorianSub={true}
  separator="→"
/>
  );
}

Code Examples

import { useState } from "react";
import ROCDateRangePicker, { type ROCDateRange } from "@/components/taiwan/ROCDateRangePicker";

export default function LeaveForm() {
  const [range, setRange] = useState<ROCDateRange>({ start: null, end: null });

  return <ROCDateRangePicker value={range} onChange={setRange} />;
}
民國紀年日期範圍validation天數計算

Related Components