# DatePicker

Нативний date/time-пікер у стилі полів бібліотеки — календар мовою пристрою.


Навмисно нативний: власний календар — це сотні рядків позиціонування,
клавіатури й i18n, а пікер браузера вже вміє все це мовою пристрою.
Компонент додає те, чого не дає сирий input: стилі полів бібліотеки,
label/error/hint-контракт і токенізовану темну тему.

## Приклад


Example (app/demos/date-picker/DatePickerBasic.vue):

```vue
<script setup lang="ts">
import { ref } from 'vue'
import UiDatePicker from '~/components/ui/UiDatePicker.vue'

const date = ref('2026-08-27')
</script>

<template>
  <div class="w-full max-w-sm">
    <UiDatePicker v-model="date" label="Дата публікації" />
  </div>
</template>
```


## API

[Props, events, slots, exposed API (JSON)](https://ui.tatet.net/api/component-meta/UiDatePicker)

## Коли використовувати

Дати публікацій, періоди фільтрів, терміни. `datetime-local` — для
точних до хвилини (планувальники), `time` — для часу без дати.

## Коли НЕ використовувати

Для діапазонів «від — до» потрібні два поля з перехресною валідацією
min/max, а не один компонент.

Не підмінюйте нативний пікер власним календарем «заради однакового
вигляду» — він ляже мовою пристрою, а не застосунку.

## Доступність

Нативний пікер вже має повну клавіатурну навігацію і локаль. Поле має
`label` через `for`/`id`, `aria-invalid` і `aria-describedby` на
помилку/підказку — за контрактом полів бібліотеки.

Атрибути, що не є props (`step`, `aria-label`, `data-*`), ідуть на сам
`<input>`, а `class` і `style` — на обгортку.

## Event descriptions

- `update:modelValue`: Значення у форматі нативного поля або `null`, якщо очищено.
- `focus`: Поле отримало фокус.
- `blur`: Поле втратило фокус.


[Source files, dependencies and ZIP](https://ui.tatet.net/registry/components/date-picker.json)
