Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

HTMLModElement : propriété dateTime

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨juillet 2015⁩.

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 :

html
<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> :

js
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é :

js
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 :

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

Spécifications

Specification
HTML
# dom-mod-datetime

Compatibilité des navigateurs

Voir aussi