Date, objet

Article
08/10/2011

Objet qui permet le stockage et la récupération de base de dates et d'heures. Le constructeur Date se présente sous deux formes.

function Date( [dateVal : { Number | String | System.DateTime } ] )
function Date( year : int, month : int, date : int[, hours : int [, minutes : int [, seconds : int [, ms : int]]]] )

Arguments

dateVal
Facultatif. S'il s'agit d'une valeur numérique, dateVal représente le nombre de millisecondes en temps universel coordonné entre la date spécifiée et le 1er janvier 1970 à minuit. Si une chaîne, dateVal est analysé d'après les règles dans la méthode parse. dateVal peut également être une valeur de date .NET.
year
Obligatoire. Millésime complet, par exemple 1976 (et non 76).
month
Obligatoire. Mois, représenté par un entier compris entre 0 et 11 (janvier à décembre).
date
Obligatoire. Date, représentée par un entier compris entre 1 et 31.
hours
Facultatif. Doit être spécifié si l'argument minutes est fourni. Entier compris entre 0 et 23 (minuit à 23 heures) indiquant l'heure.
minutes
Facultatif. Doit être spécifié si l'argument seconds est fourni. Entier compris entre 0 et 59 indiquant les minutes.
secondes
Facultatif. Doit être spécifié si l'argument milliseconds est fourni. Entier compris entre 0 et 59 indiquant les secondes.
ms
Facultatif. Entier compris entre 0 et 999 indiquant les millisecondes.

Notes

Un objet Date contient un nombre indiquant un instant déterminé avec une précision de l'ordre de la milliseconde. Si la valeur d'un argument est en dehors de la plage de sélection ou si elle est négative, les autres valeurs stockées sont modifiées en conséquence. Par exemple, si vous spécifiez 150 secondes, JScript convertit ce nombre en deux minutes et trente secondes.

Si le nombre est NaN, l'objet ne représente pas un instant précis. Si aucun paramètre n'est passé au constructeur Date, celui-ci est initialisé à l'heure actuelle (UTC). Une variable de type Date doit être initialisée avant que vous puissiez l'utiliser.

La plage de dates pouvant être représentée dans un objet Date couvre environ 285 616 années, avant et après le 1er janvier 1970.

L'objet Date a deux méthodes statiques, parse et UTC, qui sont appelées sans créer d'objet Date.

Si le constructeur Date est appelé sans l'opérateur new, l'objet Date retourné contient la date du jour, quels que soient les arguments passés au constructeur.

Notes

L'objet Date interagit avec le type de données du .NET Framework System.DateTime dans JScript. En revanche, d'autres langages CLS (Common Language Specification) ne peuvent pas utiliser l'objet Date dans la mesure où JScript .NET est le seul langage à fournir l'objet ; il n'est pas dérivé d'un type du .NET Framework. En conséquence, lors de l'annotation de type des paramètres et des types de retour des méthodes conformes à CLS, assurez-vous d'utiliser le type de données System.DateTime plutôt que l'objet Date. Vous pouvez néanmoins utiliser l'objet Date pour annoter le type d'identificateurs autres que des paramètres et des types de retour. Pour plus d'informations, consultez Écriture d'un code conforme CLS.

Consultez Calculs de date et d'heure pour plus d'informations sur l'utilisation de l'objet Date et méthodes connexes.

Exemple

L'exemple suivant utilise l'objet Date.

var s : String = "Today's date is: ";   // Declare variables.
var d : Date = new Date();              // Create Date object with today's date.
s += (d.getMonth() + 1) + "/";          // Get month
s += d.getDate() + "/";                 // Get day
s += d.getYear();                       // Get year.
print(s);                               // Print date.

Si ce programme avait été exécuté le 26 janvier 1992, il aurait donné pour résultat :