MarsalaDS

Buscar

Páginas e componentes da documentação

Date Time Picker

Uso

Módulo com cinco exports: DatePicker, DateRangePicker, DateTimePicker, TimePicker e DateTimeRangePicker. Data no InputGroup (digitação dd/mm/aaaa + ícone de calendário no fim); o Calendar abre só pelo ícone, alinhado à direita do campo com pequeno espaço. Hora é sempre digitada (hh:mm, normaliza no blur) — sem seletor nativo.

Quando usar

  • DatePicker: value Date, parse ao blur (vários formatos) e seleção no Calendar.
  • DateRangePicker: um campo com intervalo (traço –) e Calendar mode range.
  • DateTimePicker: data + campo de hora ao lado; onValueChange devolve Date com hora.
  • TimePicker: string HH:mm controlada; defaultValue 09:00.
  • DateTimeRangePicker: intervalo de datas + horários início/término em Field.
  • open/defaultOpen/onOpenChange no popover do calendário; locale no Calendar (padrão ptBR).

Evite quando

  • Não use para calendário sempre visível — prefira Calendar inline na página.
  • Não espere picker de hora ao clicar — só digitação.
  • Confirmação crítica — Dialog.

Instalação

Com o namespace @youxgroup configurado em components.json (veja Instalação).

pnpm dlx shadcn@latest add @youxgroup/date-time-picker

Exemplos

Variações comuns de uso.

Só data

Intervalo de datas

Data e hora

Só hora

Intervalo com horas

Com Field

Digite a data ou use o ícone do calendário no fim do campo.

Marsala Design System