Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

time — data lub czas w formie czytelnej maszynowo

Element `time` oznacza datę, godzinę lub czas trwania. Atrybut `datetime` pozwala połączyć tekst dla czytelnika z jednoznacznym zapisem dla programów.

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

Składnia

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

time nadaje treści znaczenie związane z datą lub czasem. Opcjonalny datetime zawiera jej maszynowy odpowiednik. Bez niego sam tekst musi mieć dozwolony format, a element nie może mieć potomnych elementów. Oba znaczniki są wymagane.

Dozwolone zapisy obejmują miesiąc 2026-11, datę 2026-11-18, datę bez roku 11-18, godzinę 14:30, lokalną datę i godzinę 2026-11-18T14:30, przesunięcie +01:00, globalną datę i godzinę 2026-11-18T14:30Z, tydzień 2026-W47, rok 2026 oraz czas trwania PT30M. Rok wymaga co najmniej czterech cyfr ASCII i nie może być zerem. Daty muszą być kalendarzowo poprawne.

Lokalna data i godzina nie określa jednego globalnego momentu; zapis globalny zawiera Z lub przesunięcie UTC. Przesunięcie nie jest nazwą geograficznej strefy czasowej.

W przykładzie tekst i datetime opisują tę samą datę. Właściwość DOM dateTime odzwierciedla atrybut datetime; oczekiwany wynik konsoli to 2026-11-18.

Przykłady

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

Wynik

2026-11-18

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła