CKTIS / HTML
time — datas e horas legíveis por máquina
O elemento `time` assinala uma data, uma hora ou uma duração. O seu atributo `datetime` associa um texto fácil de ler a uma representação inequívoca legível por máquina.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<time datetime="YYYY-MM-DD">human-readable date</time>time atribui ao seu conteúdo um significado relacionado com datas ou horas. O atributo opcional datetime fornece o equivalente legível por máquina. Sem este atributo, o próprio texto tem de seguir um formato permitido e o elemento não pode ter elementos descendentes. Ambas as etiquetas são obrigatórias.
As representações permitidas incluem um mês 2026-11, uma data 2026-11-18, uma data sem ano 11-18, uma hora 14:30, uma data e hora locais 2026-11-18T14:30, um desvio +01:00, uma data e hora globais 2026-11-18T14:30Z, uma semana 2026-W47, um ano 2026 e uma duração PT30M. Um ano requer pelo menos quatro algarismos ASCII e não pode ser zero. As datas têm de ser válidas no calendário.
Uma data e hora local não identifica um único instante global; uma representação global inclui Z ou um desvio UTC. Um desvio não é o nome de um fuso horário geográfico.
No exemplo, o texto e datetime descrevem a mesma data. A propriedade DOM dateTime reflete o atributo datetime; o resultado esperado na consola é 2026-11-18.
Exemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Time example</title>
<p><time id="event" datetime="2026-11-18">18 November 2026</time></p>
<script>
const eventTime = document.getElementById('event');
console.log(eventTime.dateTime);
</script>
</html>Resultado
2026-11-18
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.