CKTIS / HTML
datetime: czas w formacie maszynowym
Oddziel czytelną etykietę od precyzyjnej daty, czasu lub znacznika zmiany.
Wersja: HTML Living Standard
Składnia
<time datetime="2026-11-18T10:00:00+01:00">Morning meeting</time>Na time atrybut datetime podaje maszynową reprezentację widocznej treści. Dozwolone formaty obejmują daty, czasy, miesiące, tygodnie, okresy i określone zapisy daty z czasem; nie wszystkie są pełnymi znacznikami czasu JavaScript. Na elementach wstawienia i usunięcia opisuje datę zmiany, opcjonalnie z czasem globalnym.
Stosuj składnię właściwą dla elementu. Lokalna data z czasem bez przesunięcia nie wskazuje jednego momentu na świecie. Dla wspólnej chwili podaj przesunięcie lub oznaczenie UTC; samo przesunięcie nie opisuje reguł geograficznej strefy czasowej. Atrybut nie tłumaczy ani nie podmienia widocznej etykiety.
Przykład porównuje dwie pełne daty z czasem i różnymi przesunięciami, oznaczające tę samą chwilę. JavaScript potwierdza równość, a czytelna etykieta pozostaje niezmieniona. Nie oznacza to, że każdą prawidłową wartość czasu HTML można parsować tak samo.
Przykłady
<!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>Wynik
sameInstant=true; visible=Morning meeting
Porównanie celowo używa pełnych dat i jawnych przesunięć, nie niejednoznacznych czasów lokalnych.