ДокументацияЛокали и форматы

Локали и форматы

По умолчанию: locale = ru, dateFormat = 'dd.MM.yyyy'. Любая локаль date-fns подключается одним пропсом — маска ввода, плейсхолдер и парсинг пересчитываются автоматически.

Пример: en-US

import { enUS } from 'date-fns/locale'
import { DatePicker } from 'daterly'
 
<DatePicker
  locale={enUS}
  dateFormat="MM/dd/yyyy"
  label="Birth date"
/>

Маска ввода: __/__/____. Плейсхолдер: mm/dd/yyyy. Календарь — на английском.

Пример: ISO

import { enUS } from 'date-fns/locale'
 
<DatePicker
  locale={enUS}
  dateFormat="yyyy-MM-dd"
  label="ISO date"
/>

Маска: ____-__-__. Плейсхолдер: yyyy-mm-dd.

Пример: немецкий

import { de } from 'date-fns/locale'
 
<DatePicker locale={de} dateFormat="dd.MM.yyyy" label="Geburtsdatum" />

Поддерживаемые токены dateFormat

ТокенЗначение
ddДень, 2 цифры
MMМесяц, 2 цифры
yyyyГод, 4 цифры

Все три должны присутствовать в формате ровно по одному разу. В качестве разделителей принимаются любые одиночные символы (., /, -, ).

Время — отдельным пропсом showTime, не через dateFormat. Если передать HH, mm или ss в dateFormat — будет ошибка.

Плейсхолдер

  • Для locale.code === 'ru' — русские буквы: дд.мм.гггг, чч:мм.
  • Для остальных локалей — латиница: dd.mm.yyyy, hh:mm.

Можно переопределить пропом placeholder:

<DatePicker placeholder="Выберите дату..." />

Список локалей

Все локали date-fns импортируются из date-fns/locale:

import { ru, enUS, enGB, de, fr, es, it, ja, ko, zhCN } from 'date-fns/locale'

Полный список — на сайте date-fns.