外觀

多個月份

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

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

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

  return (
    <DateRangeTimePicker
      value={value}
      onChange={setValue}
      numberOfMonths={3}
      time={{ minuteStep: 5 }}
    />
  );
}

自訂語系

從 headless 套件匯入並使用 createLocale 來客製化月份/星期的名稱和 UI 字串。

import { useState } from "react";
import { DateRangeTimePicker } 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 (
    <DateRangeTimePicker
      value={value}
      onChange={setValue}
      locale={koLocale}
      time={{ minuteStep: 5 }}
    />
  );
}

標題下拉選單

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

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

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

  return (
    <DateRangeTimePicker
      value={value}
      onChange={setValue}
      captionLayout="dropdown"
      fromYear={2020}
      toYear={2030}
      time={{ minuteStep: 5 }}
    />
  );
}