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.