Document.lastModified

Cet article nécessite une relecture rédactionnelle. Voici comment vous pouvez aider.

Retourne une chaîne de caractère contenant la date et l'heure à laquelle le présent document a été modifié pour la dernière fois.

Syntaxe

string = document.lastModified; 

Exemples

Exemple #1: Utilisation simple

alert(document.lastModified); 
// renvoie: 11/28/2015 16:11:15

Exemple #2: Transformer lastModified en un objet de type Date

var oLastModif = new Date(document.lastModified);

Exemple #3: Transformer lastModified en un nombre de millisecondes passées depuis le 1 Janvier 1970 à 00:00:00, heure locale.

var nLastModif = Date.parse(document.lastModified);

Notes

Veuillez noter qu'en tant que chaîne de caractère, lastModified ne peut être facilement utilisé pour des comparaisons entre les dates modifées des documents. Voici un exemple possible qui montre comment afficher une alerte quand la page change (voir aussi: API des cookies en JavaScript):

if (Date.parse(document.lastModified) > parseFloat(document.cookie.replace(/(?:(?:^|.*;)\s*last_modif\s*\=\s*([^;]*).*$)|^.*$/, "$1") || "0")) {
    document.cookie = "last_modif=" + Date.now() + "; expires=Fri, 31 Dec 9999 23:59:59 GMT; path=" + location.pathname;
    alert("Cette page a changé !");
}

… le même exemple, mais en ignorant la première visite:

var

    nLastVisit = parseFloat(document.cookie.replace(/(?:(?:^|.*;)\s*last_modif\s*\=\s*([^;]*).*$)|^.*$/, "$1")),
    nLastModif = Date.parse(document.lastModified);

if (isNaN(nLastVisit) || nLastModif > nLastVisit) {
    document.cookie = "last_modif=" + Date.now() + "; expires=Fri, 31 Dec 9999 23:59:59 GMT; path=" + location.pathname;
    if (isFinite(nLastVisit)) {
        alert("Cette page a changé !");
    }
}
Note: WebKit renvoie le temps sous forme de chaîne de caractère en UTC; Gecko et Internet Explorer renvoient le temps selon le fuseau horaire local.
(Voir: Bogue 4363 – document.lastModified renoive la date en UTC, mais devrait la renvoyer selon le fuseau horaire local)

Si vous voulez savoir si une page externe a changé, veuillez lire ce paragraphe à propos de l'API XMLHttpRequest().

Spécification

HTML5

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : DaweedM
 Dernière mise à jour par : DaweedM,