База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

datetime: машинно четима информация за време

Отделете четимия надпис от точната дата, час или момент на промяна.

Версия: HTML Living Standard

Синтаксис

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

При time атрибутът datetime дава машинно четима стойност на видимото съдържание. Допустими са дати, часове, месеци, седмици, продължителности и определени форми на дата с час; не всички са пълни времеви означения за JavaScript. При елементите за вмъкване и изтриване атрибутът вместо това описва датата на промяната, по избор с глобално време.

Използвайте синтаксиса, разрешен за конкретния елемент. Локална дата с час без отместване не определя единствен момент в света. За общ момент включете отместване или означение UTC и не приемайте, че отместването описва правилата на географска часова зона. Атрибутът не превежда и не заменя автоматично видимия надпис.

Примерът сравнява две пълни дати с час и различни отмествания, представляващи един момент. JavaScript потвърждава равенството, а четимият надпис остава непроменен. Това не означава, че всяка разрешена HTML времева стойност може да се анализира по същия начин.

Примери

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

Резултат

sameInstant=true; visible=Morning meeting

Сравнението нарочно използва пълни дати с изрични отмествания, а не двусмислено локално време.

Източници