HTMLModElement: dateTime property
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
ThedateTime property of theHTMLModElement interface is a string containing a machine-readable date with an optional time value. It reflects thedatetime HTML attribute of the<del> and<ins> elements.
Value
A string. For valid string formats, see thedatetime valid values.
Examples
Given the following HTML:
<p>The paragraph <del datetime="2021-11-01">has been</del> changed</p>We can get the value of thedateTime attribute of the<del> element:
const deletedText = document.querySelector("del");console.log(deletedText.dateTime); // "2021-11-01"We can also set thedateTime property. Here, we create an<ins> element, then set thedateTime property of the<ins> element to the current date inYYYY-MM-DD format then insert it after the deleted text:
const insertedText = document.createElement("ins");const now = new Date();insertedText.dateTime = `${now.getFullYear()}-${now.getMonth() + 1}-${now.getDate()}`;insertedText.appendChild(document.createTextNode("was"));deletedText.insertAdjacentElement("afterend", insertedText);If our script ran on January 9, 2025, our HTML would be as follows:
<p> The paragraph <del datetime="2021-11-01">has been</del ><ins datetime="2025-1-9">was</ins> changed</p>Specifications
| Specification |
|---|
| HTML # dom-mod-datetime |