Date : mthode statique parse()

Exemple interactif

// Format de chane de caractres de date-heure standard
const unixTimeZero = Date.parse("1970-01-01T00:00:00Z");
// Format non standard ressemblant  toUTCString()
const javaScriptRelease = Date.parse("04 Dec 1995 00:12:00 GMT");

console.log(unixTimeZero);
// Rsultat attendu : 0

console.log(javaScriptRelease);
// Rsultat attendu : 818035920000

Syntaxe

Date.parse(dateString)

Paramtres

dateString

Une chane de caractres (string) au format date-heure. Voir la rfrence lie pour les prcautions concernant l'utilisation de diffrents formats.

Valeur de retour

Un nombre reprsentant l'horodatage (timestamp en anglais) de la date donne. Si dateString ne peut pas tre analys comme une date valide, NaN est renvoy.

Description

Cette fonction est utile pour dfinir des valeurs de date partir de chanes de caractres, par exemple en combinaison avec la mthode setTime().

Les formats que parse() peut traiter ne sont pas explicitement spcifis, mais il existe quelques invariants :

• Le format de chane de caractres date-heure (produit par toISOString()) doit tre pris en charge.
• Si x est un objet Date dont la valeur en millisecondes est zro, alors x.valueOf() doit tre gal l'une des valeurs suivantes : Date.parse(x.toString()), Date.parse(x.toUTCString()), Date.parse(x.toISOString()). Cela signifie que les formats produits par toString() et toUTCString() doivent aussi tre pris en charge.
• La spcification n'exige pas la prise en charge du format produit par toLocaleString(). Cependant, les principaux moteurs essaient tous de prendre en charge le format toLocaleString("en-US").

Les autres formats dpendent de l'implmentation et peuvent ne pas fonctionner sur tous les navigateurs. Une bibliothque peut tre utile si de nombreux formats diffrents doivent tre pris en charge. En fait, le manque de fiabilit de Date.parse() est l'une des raisons de l'introduction de l'objet Temporal.

Comme parse() est une mthode statique de Date, vous l'utilisez toujours comme Date.parse(), et non comme une mthode d'un objet Date que vous avez cr.

Exemples

Utiliser la mthode Date.parse()

Les appels suivants renvoient tous 1546300800000. Le premier impliquera l'heure UTC car il s'agit uniquement d'une date, et les autres spcifient explicitement le fuseau horaire UTC.

Date.parse("2019-01-01");
Date.parse("2019-01-01T00:00:00.000Z");
Date.parse("2019-01-01T00:00:00.000+00:00");

L'appel suivant, qui ne prcise pas de fuseau horaire, sera interprt comme le 2019-01-01 00:00:00 dans le fuseau horaire local du systme, car il contient la fois une date et une heure.

Date.parse("2019-01-01T00:00:00");

Formats toString() et toUTCString()

En plus du format standard de chane de caractres date et heure, les formats toString() et toUTCString() sont pris en charge :

// format toString()
Date.parse("Thu Jan 01 1970 00:00:00 GMT-0500 (Eastern Standard Time)");
// 18000000 dans toutes les implmentations dans tous les fuseaux horaires

// format toUTCString()
Date.parse("Thu, 01 Jan 1970 00:00:00 GMT");
// 0 dans toutes les implmentations dans tous les fuseaux horaires

Chanes de date non standard

Les implmentations utilisent gnralement le fuseau horaire local lorsque la chane de date n'est pas standard. Par cohrence, nous supposerons que l'environnement d'excution utilise le fuseau horaire UTC, et sauf indication contraire, le rsultat dpendra du fuseau horaire de l'appareil. L'heure d't (DST) du fuseau local peut aussi avoir un effet.

Voici d'autres exemples de chanes de date non standard. Les navigateurs sont trs tolrants lors de l'analyse des chanes de date et peuvent ignorer toute partie d'une chane qu'ils ne parviennent pas analyser. Pour des raisons de compatibilit, les navigateurs copient souvent le comportement les uns des autres, ce qui fait que ces schmas de gestion se propagent d'un navigateur l'autre. Comme indiqu prcdemment, les exemples suivants sont donns titre d'illustration uniquement et ne sont en aucun cas exhaustifs :

Spcifications

Compatibilit des navigateurs

Voir aussi

• La mthode statique Date.UTC()