Skip to main content

O datetime-local é um tipo de input HTML para representar uma data e hora, que substitui o tipo datetime, agora considerado obsoleto.

O datetime-local é um tipo de input HTML para representar uma data e hora, que substitui o tipo datetime (agora considerado obsoleto e sem suporte dos browsers).

Este tipo de input é similar aos tipos date e time, e permite que o usuário digite a data e hora (dia, mês, ano, hora e minuto). Um detalhe a se notar é que os segundos não são suportados, ao contrário do que acontece com o tipo time, que permite a entrada do campo de segundos.

Um exemplo de uso deste tipo:

<input type="datetime-local" id="meeting-time"
       name="meeting-time" value="2018-06-12T19:30"
       min="2018-06-07T00:00" max="2018-06-14T00:00">

A forma como este é renderizado depende do browser. Alguns podem mostrar controles para incrementar ou decrementar os campos, tomando o cuidado de deixá-los sempre dentro dos limites permitidos (dias entre 01 e 31, por exemplo, além dos valores máximo e mínimo indicados pelos atributos max e min).

Caso o browser não suporte este tipo, geralmente é mostrado como um campo de texto comum, e a documentação sugere alternativas para lidar com estes casos.

O valor de um campo datetime-local sempre será a data e hora no formato ISO 8601, ou seja: "ano-mês-dia", seguido da letra T, seguido de "hora:minuto" (os segundos são omitidos neste caso, pois o seu valor é zero). No exemplo acima, por exemplo, o valor inicial é 2018-06-12T19:30.

Este campo não oferece suporte para timezones (fuso-horários), sendo que estes devem ser tratados separadamente, conforme recomenda a documentação.