Pular para o conteúdo
Formulário

DateTimePicker

/componentes/date-time-picker.mdmarkdown cru, para quem lê com agent em vez de olho

Agendamento

Dentro de um Field

Vencimento no fim do dia

Prazo de resposta
Importar
import { DateTimePicker } from '@rivocode/ui'

Quando usar

Data e hora num valor só: agendamento, vencimento com hora, prazo de SLA.

São dois campos lado a lado, o do DatePicker (dd/mm/aaaa, com o calendário) e o do TimeField (hh:mm, com as setas), e um valor único em aaaa-mm-ddThh:mm, na hora local e sem fuso. O valor só sai quando as duas metades estão inteiras; a metade escolhida fica no campo dela e espera a outra. Apagar a data, ou a hora, responde null, e a outra metade continua lá para a próxima escolha. No celular os dois campos se empilham, porque a hora ganha os botões de mais e de menos do TimeField e não cabe ao lado da data.

const [visita, setVisita] = useState<string | null>(null)

<DateTimePicker aria-label="Visita técnica" value={visita} onValueChange={setVisita} />

defaultTime preenche a hora sozinha quando a data é escolhida com a hora vazia: defaultTime="18:00" é o vencimento no fim do dia, e um clique no calendário já fecha o valor. min e max limitam os dias, em aaaa-mm-dd; a hora não é recortada. step é o passo das setas da hora.

O componente é um grupo (role="group"), e cada campo se apresenta ao leitor de tela como "Data" e "Hora" (labels troca). Dentro de um Field, o FieldLabel nomeia o grupo e entra no nome das duas partes: quem navega campo a campo ouve "Vencimento Data" e "Vencimento Hora", e não dois campos soltos com o mesmo nome. O clique no rótulo leva à data. Fora do Field, dê o nome do grupo com aria-label, ou com aria-labelledby, que também entra no nome das partes; ou ponha a peça num Fieldset com FieldsetLegend, que diz o nome uma vez para os dois. Com name, um campo escondido leva o valor inteiro no envio, e só ele: o texto pontuado da data não vai junto. No FormField, entra pelo forValue.

<Field name="dueAt">
  <FieldLabel>Vencimento</FieldLabel>
  <DateTimePicker defaultTime="18:00" value={due} onValueChange={setDue} />
</Field>

O texto vira Date com new Date(valor), que lê na hora local. Para mandar ao servidor com fuso, converta na borda, e não no campo.

Com readOnly, os dois campos mostram o valor com a borda tracejada e nem o calendário nem o passo da hora mudam nada. Dentro de <Field disabled>, os dois ficam desligados.

Quando não usar

Quando só o dia importa, use DatePicker: hora que ninguém escolheu vira 00:00 no banco e aparece como meia-noite no relatório. Hora sozinha, sem dia (abertura da loja, janela de entrega), é TimeField. E dois horários do mesmo dia (início e fim) são dois TimeField, e não dois DateTimePicker.

No React Native

Traduz com o mesmo valor único, aaaa-mm-ddThh:mm, e a mesma regra: só sai com as duas metades, null quando uma some, e defaultTime fecha o valor na escolha da data. Os dois campos de digitar do web viram dois gatilhos de folha, o do DatePicker (o mês) e o do TimePicker (as duas colunas), porque no celular escolher é mais curto que digitar. Cada gatilho anuncia o label com a parte: "Vencimento, data" e "Vencimento, hora". Dentro de um Field, sem label, vale o rótulo do Field, como o FieldLabel faz no web; fora dele, o label é o único nome que os gatilhos têm.

min e max aceitam a hora, e aqui ela recorta. Com aaaa-mm-ddThh:mm, no dia de cada ponta a folha da hora começa ou termina nela, e nos outros dias a hora é livre; só com o dia, a hora não é recortada, como no web. A janela de todo dia é minTime e maxTime, em hh:mm, com os nomes e a conta do web: no dia de uma ponta vale a hora mais apertada entre as duas, e nos outros dias vale só a janela.

API

PropTipoPadrão
classNames

Classe por parte: `date` (o campo da data) e `time` (o campo da hora).

Partial<Record<"date" | "time", string>>sem padrão
defaultTime

A hora que entra sozinha quando a data e escolhida com a hora vazia, em `hh:mm`: "18:00" para vencimento no fim do dia.

stringsem padrão
defaultValue

O valor inicial, quando o componente controla o proprio estado.

string | nullnull
disabledbooleansem padrão
labels

Os textos da peca, para trocar o idioma: `date` e `time` sao os nomes que o leitor de tela ouve em cada campo.

Partial<DateTimePickerLabels>sem padrão
max

O ultimo momento aceito, inclusive: `aaaa-mm-dd` limita so o dia, e `aaaa-mm-ddThh:mm` limita tambem a hora no proprio dia.

stringsem padrão
maxTime

A ultima hora aceita em qualquer dia, em `hh:mm`.

stringsem padrão
min

O primeiro momento aceito, inclusive: `aaaa-mm-dd` limita so o dia, e `aaaa-mm-ddThh:mm` limita tambem a hora no proprio dia - nos outros dias a hora fica livre.

stringsem padrão
minTime

A primeira hora aceita em qualquer dia, em `hh:mm`: o expediente que abre as 08:00.

stringsem padrão
name

O nome do campo escondido que leva o valor inteiro ao formulario.

stringsem padrão
onValueChange

Chamado com o valor inteiro quando data e hora estao completas, e com `null` quando uma das duas esvazia.

((value: string | null) => void)sem padrão
readOnly

Mostra a data e a hora sem deixar mudar: os dois campos ficam com a borda tracejada, e o calendario e o passo da hora nao abrem nem andam.

booleansem padrão
size

Tamanho dos dois campos, o mesmo vocabulario do Input.

"lg""md""sm"sem padrão
step

De quantos minutos as setas da hora andam.

numbersem padrão
value

A data e a hora escolhidas, num valor so, em `aaaa-mm-ddThh:mm` e na hora local, sem fuso.

string | nullsem padrão

Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.

@rivocode/ui, 149 peças no catálogo. Esta página é gerada dos mesmos arquivos que alimentam o design system, então ela não envelhece sozinha.

Feito por RivoCode.