외형

크기

네 가지 내장 크기: small, medium, large, x-large.

import { useState } from "react";
import { DatePicker } from "react-date-range-picker-tailwind4";
import type { DatePickerSize } from "react-date-range-picker-headless";

const sizes: DatePickerSize[] = ["small", "medium", "large", "x-large"];

function Sizes() {
  const [values, setValues] = useState<Record<DatePickerSize, Date | null>>({
    small: null,
    medium: null,
    large: null,
    "x-large": null,
  });

  return (
    <div style={{ display: "flex", flexDirection: "column", gap: 20 }}>
      {sizes.map((size) => (
        <div key={size} style={{ display: "flex", alignItems: "center", gap: 12 }}>
          <span style={{ width: 60, fontSize: 13, fontWeight: 600, opacity: 0.5, flexShrink: 0 }}>
            {size}
          </span>
          <DatePicker
            value={values[size]}
            onChange={(date) => setValues((prev) => ({ ...prev, [size]: date }))}
            size={size}
          />
        </div>
      ))}
    </div>
  );
}

small

medium

large

x-large

사용자 지정 형식

표시 형식 문자열을 사용자 정의합니다.

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

function CustomFormat() {
  const [value, setValue] = useState<Date | null>(null);

  return <DatePicker value={value} onChange={setValue} displayFormat="YYYY/MM/DD" />;
}

사용자 지정 로케일

headless 패키지의 createLocale을 사용하여 국제화를 위한 사용자 지정 로케일을 제공합니다.

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

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

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

  return <DatePicker value={value} onChange={setValue} locale={koLocale} weekStartsOn="monday" />;
}

한 주의 시작

한 주의 시작 요일을 변경합니다. 기본값은 "sunday"입니다.

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

function WeekStartsOn() {
  const [value, setValue] = useState<Date | null>(null);

  return <DatePicker value={value} onChange={setValue} weekStartsOn="monday" />;
}

이전/다음 달 날짜 표시

달력 그리드를 채우기 위해 인접한 달의 날짜를 표시합니다. 기본값은 false입니다.

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

function ShowOutsideDays() {
  const [value, setValue] = useState<Date | null>(null);

  return <DatePicker value={value} onChange={setValue} showOutsideDays />;
}

캡션 드롭다운

월/연도 탐색을 화살표에서 captionLayout="dropdown"으로 드롭다운으로 전환합니다. fromYear와 toYear를 사용하여 연도 범위를 설정합니다.

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

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

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