Référence de JavaScript 1.5 Core:Objets globaux:Date:parse
Un article de MDC.
Sommaire |
[modifier] Résumé
Analyse une représentation texte d'une date, et renvoie le nombre de millièmes de secondes depuis le 1er janvier 1970, 00:00:00, heure locale.
| Méthode de Date | |
| Statique | |
| Implémentation : | JavaScript 1.0, NEX 2.0 |
| Version ECMA : | ECMA-262 |
[modifier] Syntaxe
Date.parse(dateString);
[modifier] Paramètres
-
dateString - Une chaîne représentant une date (en anglais).
[modifier] Description
La méthode parse prend une chaîne contenant une date en paramètre (comme "Dec 25, 1995") et renvoie le nombre de millièmes de secondes depuis le 1er janvier 1970, 00:00:00 (heure locale). Cette fonction est utile pour définir des valeurs de dates à partir de représentations texte, par exemple en conjonction avec la méthode setTime et l'objet Date.
À partir d'une chaîne représentant une date, parse renvoie une valeur de temps. Elle accepte la syntaxe de date standard de l'IETF : "Mon, 25 Dec 1995 13:30:00 GMT". Elle comprend les abréviations de fuseaux horaires continentaux des États-Unis, mais en général on utilisera plutôt un décalage, par exemple "Mon, 25 Dec 1995 13:30:00 GMT+0430" (4 heures 30 minutes à l'ouest du méridien de Greenwich). Si aucun fuseau horaire n'est spécifié, on suppose qu'il s'agit de l'heure locale. Les indicateurs GMT et UTC sont considérés comme équivalents.
Comme parse est une méthode statique de Date, on l'utilise toujours sous la forme Date.parse(), plutôt que comme une méthode d'un objet Date que vous auriez créé.
[modifier] Exemples
[modifier] Exemple : utilisation de parse
Si IPOdate est un objet Date existant, vous pouvez le positionner au 9 août 1995 comme suit :
IPOdate.setTime(Date.parse("Aug 9, 1995"));