Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

time — date e orari leggibili dalle macchine

L’elemento `time` contrassegna una data, un orario o una durata. Il suo attributo `datetime` abbina un testo leggibile alle persone a una rappresentazione non ambigua leggibile dalle macchine.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

<time datetime="YYYY-MM-DD">human-readable date</time>

time attribuisce al contenuto un significato legato a date o orari. L’attributo facoltativo datetime ne fornisce l’equivalente leggibile dalle macchine. Se manca, il testo stesso deve rispettare un formato consentito e l’elemento non deve avere elementi discendenti. Entrambi i tag sono obbligatori.

Le rappresentazioni consentite includono un mese 2026-11, una data 2026-11-18, una data senza anno 11-18, un orario 14:30, una data e ora locali 2026-11-18T14:30, uno scostamento +01:00, una data e ora globali 2026-11-18T14:30Z, una settimana 2026-W47, un anno 2026 e una durata PT30M. Un anno richiede almeno quattro cifre ASCII e non può essere zero. Le date devono essere valide nel calendario.

Una data e ora locale non identifica un singolo istante globale; una rappresentazione globale include Z o uno scostamento UTC. Uno scostamento non è il nome di un fuso orario geografico.

Nell’esempio, il testo e datetime descrivono la stessa data. La proprietà DOM dateTime rispecchia l’attributo datetime; l’output atteso nella console è 2026-11-18.

Esempi

<!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>

Risultato

2026-11-18

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti