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 :
<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
| Specification |
|---|
| HTML # dom-mod-datetime |
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()