parse, méthode

Article
08/21/2008

Mise à jour : novembre 2007

Analyse une chaîne contenant une date et retourne le nombre de millisecondes entre cette date et le 1er janvier 1970 à minuit.

function parse(dateVal : {String | System.DateTime} ) : Number

Arguments

dateVal
Obligatoire. Chaîne contenant une date dans un format du type « 5 Jan 1996 08:47:00 » ou valeur VT_DATE récupérée d'un objet ActiveX® ou autre.

Notes

La méthode parse retourne une valeur entière représentant le nombre de millisecondes écoulées entre le 1er janvier 1970 à minuit et la date fournie dans dateVal.

La méthode parse est une méthode statique de l'objet Date. En tant que méthode statique, elle est appelée comme le montre l'exemple suivant, au lieu d'être appelée comme une méthode standard d'un objet Date créé.

var datestring = "November 1, 1997 10:15 AM";
Date.parse(datestring)

Les règles ci-dessous définissent le domaine d'analyse de la méthode parse :

Les dates courtes peuvent être spécifiées avec les séparateurs « / » ou « - », mais doivent être indiquées selon le format jour/mois/année « 20/7/96 », par exemple.
Pour les dates longues de format « 10 juillet 1995 », l'année, le mois et le jour peuvent être spécifiés dans n'importe quel ordre, et l'année peut être indiquée sur 2 ou 4 chiffres. Le format à 2 chiffres ne s'applique que pour les années postérieures à 69.
Tout texte placé entre parenthèses est considéré comme un commentaire. Ces parenthèses peuvent être imbriquées.
Les virgules et les espaces sont traités comme des délimiteurs. Les délimiteurs multiples sont autorisés.
Les noms de mois et de jour doivent comporter au moins deux caractères. Pour les noms à deux caractères qui ne sont pas uniques, la dernière correspondance est reconnue. Par exemple, « Ju » est reconnu comme juillet et non pas comme juin.
Le jour de la semaine est pris en compte même s'il ne correspond pas au reste de la date fournie. Par exemple, la date du « Mardi 9 novembre 1996 » est acceptée même si elle correspond en fait à un vendredi. L'objet Date retourné contient « Vendredi 9 novembre 1996 ».
JScript prend en charge tous les fuseaux horaires standard, ainsi que le temps universel (UTC, Universal Time Coordinated) et l'heure de Greenwich (GMT, Greenwich Mean Time).
Les heures, les minutes et les secondes sont séparées par des signes deux-points, même si tous n'ont pas besoin d'être spécifiés. Par exemple, « 10: », « 10:11 » et « 10:11:12 » sont des heures valides.
Si le système horaire sur 24 heures est employé, la spécification de la mention « PM » pour les heures ultérieures à 12 heures génère une erreur. Ainsi, « 23:15 PM » produit une erreur.
Une chaîne contenant une date non valide produit une erreur. Par exemple, une chaîne comportant deux années ou deux mois génère une erreur.

Exemple

L'exemple ci-dessous illustre l'utilisation de la méthode parse. Si une date est spécifiée pour la fonction, cette dernière retourne la différence entre la date indiquée et le 1/1/1970 :

function GetTimeTest(testdate){
   var s, t;                    //Declare variables.
   var MinMilli = 1000 * 60;       //Initialize variables.
   var HrMilli = MinMilli * 60;
   var DyMilli = HrMilli * 24;
   t = Date.parse(testdate);       //Parse testdate.
   s = "There are "                //Create return string.
   s += Math.round(Math.abs(t / DyMilli)) + " days "
   s += "between " + testdate + " and 1/1/70";
   return(s);                      //Return results.
}