Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

datetime: informação temporal legível por máquinas

Separe o rótulo humano de uma data, hora ou alteração precisa.

Versão: HTML Living Standard

Sintaxe

<time datetime="2026-11-18T10:00:00+01:00">Morning meeting</time>

Em time, datetime fornece uma representação processável do conteúdo visível. São permitidos datas, horas, meses, semanas, durações e certos formatos combinados; nem todos são marcas temporais JavaScript completas. Em elementos de inserção e eliminação descreve a data da alteração, opcionalmente com hora global.

Use a sintaxe permitida para o elemento. Uma data e hora local sem desfasamento não identifica um instante mundial único. Para um instante partilhado inclua desfasamento ou UTC; um desfasamento não representa as regras de um fuso geográfico. O atributo não traduz nem substitui automaticamente o rótulo visível.

O exemplo compara duas datas e horas completas com desfasamentos diferentes referentes ao mesmo instante. O JavaScript confirma a igualdade enquanto o rótulo permanece intacto. Isto não implica que todos os valores temporais HTML válidos possam ser analisados da mesma forma.

Exemplos

<!doctype html><meta charset="utf-8">
<time id="local" datetime="2026-11-18T10:00:00+01:00">Morning meeting</time>
<time id="utc" datetime="2026-11-18T09:00:00Z">UTC reference</time><output id="result"></output>
<script>
const local = document.querySelector('#local'), utc = document.querySelector('#utc');
const sameInstant = Date.parse(local.dateTime) === Date.parse(utc.dateTime);
document.querySelector('#result').textContent = 'sameInstant=' + sameInstant + '; visible=' + local.textContent;
</script>

Resultado

sameInstant=true; visible=Morning meeting

A comparação usa datas e horas completas com desfasamentos explícitos, não horas locais ambíguas.

Fontes