La propriété dateTime de l'interface HTMLModElement est une chaîne de caractères contenant une date lisible par machine, avec une valeur d'heure facultative. Elle reflète l'attribut HTML datetime des éléments <del> et <ins>.

Valeur

Une chaîne de caractères. Pour les formats valides, voir valeurs valides de datetime.

Exemples

Étant donné le HTML suivant :

<p>Le paragraphe <del datetime="2021-11-01">a été</del> modifié</p>

On peut obtenir la valeur de l'attribut dateTime de l'élément <del> :

const deletedText = document.querySelector("del");
console.log(deletedText.dateTime); // "2021-11-01"

On peut aussi définir la propriété dateTime. Ici, on crée un élément <ins>, puis on définit sa propriété dateTime à la date courante au format YYYY-MM-DD, puis on l'insère après le texte supprimé :

const insertedText = document.createElement("ins");
const now = new Date();
insertedText.dateTime = `${now.getFullYear()}-${now.getMonth() + 1}-${now.getDate()}`;
insertedText.appendChild(document.createTextNode("a été"));
deletedText.insertAdjacentElement("afterend", insertedText);

Si notre script s'exécute le 9 janvier 2025, notre HTML serait :

<p>
  Le paragraphe <del datetime="2021-11-01">a été</del
  ><ins datetime="2025-1-9">a été</ins> modifié
</p>

Spécifications

Compatibilité des navigateurs

Voir aussi

• L'élément HTML <del>
• L'élément HTML <ins>
• L'interface HTMLModElement
• La propriété HTMLModElement.cite
• La propriété HTMLTimeElement.dateTime
• Représentation des dates
• Représentation des dates et heures locales
• L'objet Date
• La méthode Element.insertAdjacentElement()