外觀

多個月份

並排顯示超過 2 個月份。對於範圍選擇器，預設為 2。

import { useState } from "react";
import { DateRangePicker } from "react-date-range-picker-tailwind4";

function MultiMonth() {
  const [value, setValue] = useState<{ start: Date | null; end: Date | null }>({
    start: null,
    end: null,
  });

  return <DateRangePicker value={value} onChange={setValue} numberOfMonths={3} />;
}

自訂語系

從 headless 套件中使用 createLocale 來自訂月份/星期名稱和 UI 字串。

import { useState } from "react";
import { DateRangePicker } from "react-date-range-picker-tailwind4";
import { createLocale } from "react-date-range-picker-headless";

const koLocale = createLocale("ko-KR", {
  confirm: "확인",
  cancel: "취소",
  clear: "초기화",
  today: "오늘",
  rangePlaceholder: "날짜 범위 선택",
  rangeSeparator: " ~ ",
});

function CustomLocale() {
  const [value, setValue] = useState<{ start: Date | null; end: Date | null }>({
    start: null,
    end: null,
  });

  return <DateRangePicker value={value} onChange={setValue} locale={koLocale} />;
}

標題下拉選單

將按鈕導覽切換為月份和年份的下拉選單。這對於選擇遠離當前月份的日期很有用。

import { useState } from "react";
import { DateRangePicker } from "react-date-range-picker-tailwind4";

function CaptionDropdown() {
  const [value, setValue] = useState<{ start: Date | null; end: Date | null }>({
    start: null,
    end: null,
  });

  return (
    <DateRangePicker
      value={value}
      onChange={setValue}
      captionLayout="dropdown"
      fromYear={2020}
      toYear={2030}
    />
  );
}