26


Date
Crée des instances de Date permettant de travailler avec des dates et des heures.
Syntaxe
new Date();
new Date(millisecondes);
new Date(dateString);
new Date(année, mois, jour [, heure, min, sec, ms ]);
Paramètres
millisecondes 
Valeur entière correspondant au nombre de millisecondes (millièmes de seconde) depuis le 1er Janvier 1970 00:00:00 UTC.
dateString 
Chaîne de caractères représentant la date. La chaîne doit être formatée d'une manière reconnue par parse.
année
Valeur entière représentant l'année. Pour des raisons de compatibilité (pour éviter le problème de l'an 2000), il convient de toujours spécifier l'année en entier ; utilisez toujours 1998 plutôt que 98.
mois
Valeur entière représentant le mois, en commençant à 0 pour janvier, jusqu'à 11 pour décembre.
jour
Valeur entière représentant le jour du mois.
heure
Valeur entière représentant l'heure dans la journée (sur une échelle de 24 heures).
min
Valeur entière représentant les minutes dans l'heure.
sec
Valeur entière représentant les secondes dans la minute.
ms
Valeur entière représentant les millièmes de secondes.
Description
Si aucun paramètre n'est fourni, le constructeur crée un objet Date pour la date et l'heure courantes selon l'heure locale. Si vous fournissez certains paramètres, mais pas d'autres, les paramètres manquants auront pour valeur 0. Dans le cas où vous en fournissez certains, vous devez au moins fournir l'année, le mois et le jour. Vous pouvez omettre les heures, les minutes, les secondes et les millisecondes.
La date est mesurée en millisecondes depuis le 1er janvier 1970 UTC à minuit. Un jour contient 86 400 000 millisecondes. L'étendue de définition d'un objet Date est de -100 000 000 jours à 100 000 000 jours par rapport au 1er janvier 1970 UTC.
L'objet Date se comporte de la même manière quelle que soit la plateforme.
L'objet Date fournit un certain nombre de méthodes UTC (universelles), ainsi que des méthodes d'heure locale. Le temps universel coordonné UTC, parfois abusivement appelée l'Heure de Greenwich (GMT), se rapporte au temps défini par la norme de temps civil international. L'heure locale est celle connue de l'ordinateur où JavaScript est exécuté.
L'invocation de Date dans un autre contexte que celui d'un constructeur (c'est-à-dire sans l'opérateur new) renverra une chaîne représentant l'heure courante.
Propriétés
Pour les propriétés héritées par les instances de Date consultez Propriétés des instances de Date.
prototype
Permet d'ajouter des propriétés à un objet Date.

Proppriétés héritées de Function.prototype
caller, constructor, length, name

Méthodes
Pour les méthodes héritées par les instances de Date consultez Méthodes des instances de Date.
now
Non standard
Renvoie la valeur numérique correspondant à l'heure courante.
parse
Analyse une chaîne contenant la représentation d'une date, et renvoie le nombre de millisecondes depuis le 1er janvier 1970, 00:00:00, heure locale.
UTC
Accepte les mêmes paramètres que la forme longue du constructeur, et renvoie le nombre de millisecondes d'un objet Date depuis le 1er janvier 1970, 00:00:00, temps universel.

Méthodes héritées de Function.prototype
apply, call, toSource, toString, valueOf
Méthodes héritées de Object.prototype
__defineGetter__, __defineSetter__, hasOwnProperty, isPrototypeOf, __lookupGetter__, __lookupSetter__, __noSuchMethod__, propertyIsEnumerable, unwatch, watch

Instances de Date
Lest instances de </div>Date</code> héritent de R%C3%A9f%C3%A9rence_de_JavaScript_1.5_Core:Objets_globaux:Date:prototypeDate.prototype. L'objet prototype du constructeur peut être modifié pour affecter les propriétés et méthodes héritées par les instances de <code>Date.
Pour la compatibilité avec les calculs de saut de millénaire (autrement dit, pour tenir compte de l'année 2000), il faut toujours préciser l'année au complet ; par exemple, utilisez 1998, pas 98. Pour vous aider dans l'utilisation d'années complètes, JavaScript fournit les méthodes getFullYear, setFullYear, getUTCFullYear et setUTCFullYear.
=== Propriétés ===
constructor
Renvoie la fonction de création d'une instance. Il s'agit du constructeur </div>Date</code> par défaut.
=== Méthodes ===
getDate
Rrenvoie le jour du mois pour la date spécifiée selon l'heure locale.
getDay
Rrenvoie le jour de la semaine pour la date spécifiée selon l'heure locale.
getFullYear
Renvoie l'année pour la date spécifiée selon l'heure locale.
getHours
Renvoie l'heure pour la date spécifiée selon l'heure locale.
getMilliseconds
Renvoie les millièmes de secondes pour la date spécifiée selon l'heure locale.
getMinutes
Renvoie les minutes pour la date spécifiée selon l'heure locale.
getMonth
Renvoie le mois pour la date spécifiée selon l'heure locale.
getSeconds
Renvoie les secondes pour la date spécifiée selon l'heure locale.
getTime
Renvoie la valeur numérique de la date spécifiée sous la forme du nombre de millisecondes depuis le 1er janvier 1970, 00:00:00 UTC.
getTimezoneOffset
Renvoie le décalage de fuseau horaire en minutes pour l'heure locale courante.
getUTCDate
Renvoie le jour (date) du mois pour la date spécifiée selon le temps universel.
getUTCDay
Renvoie le jour de la semaine pour la date spécifiée selon le temps universel.
getUTCFullYear
Renvoie l'année pour la date spécifiée selon le temps universel.
getUTCHours
Renvoie les heures pour la date spécifiée selon le temps universel.
getUTCMilliseconds
Renvoie les millièmes de seconde pour la date spécifiée selon le temps universel.
getUTCMinutes
Renvoie les minutes pour la date spécifiée selon le temps universel.
getUTCMonth
Renvoie le mois pour la date spécifiée selon le temps universel.
getUTCSeconds
Renvoie les secondes pour la date spécifiée selon le temps universel.
getYear
Déprécié
Renvoie (l'année-1900) pour la date spécifiée selon l'heure locale. Utilisez plutôt getFullYear.
setDate
Définit le jour du mois pour la date spécifiée selon l'heure locale.
setFullYear
Définit l'année complète pour la date spécifiée selon l'heure locale.
setHours
Définit les heures pour la date spécifiée selon l'heure locale.
setMilliseconds
Définit les millièmes de seconde pour la date spécifiée selon l'heure locale.
setMinutes
Définit les minutes pour la date spécifiée selon l'heure locale.
setMonth
Définit le mois pour la date spécifiée selon l'heure locale.
setSeconds
Définit les secondes pour la date spécifiée selon l'heure locale.
setTime
Règle l'objet <code>Date sur le temps représenté par un nombre de millisecondes depuis le 1er janvier 1970, 00:00:00 UTC.
setUTCDate
Définit le jour du mois pour la date spécifiée selon le temps universel.
setUTCFullYear
Définit l'année complète pour la date spécifiée selon le temps universel.
setUTCHours
Définit les heures pour la date spécifiée selon le temps universel.
setUTCMilliseconds
Définit les millièmes de seconde pour la date spécifiée selon le temps universel.
setUTCMinutes
Définit les minutes pour la date spécifiée selon le temps universel.
setUTCMonth
Définit le mois pour la date spécifiée selon le temps universel.
setUTCSeconds
Définit les secondes pour la date spécifiée selon le temps universel.
setYear
Déprécié
Définit l'année-1900 pour une date spécifiée selon l'heure locale. Utilisez plutôt setFullYear.
toDateString
Renvoie la partie « date » de l'objet Date sous la forme d'une chaîne de caractères lisible.
toGMTString
Déprécié
Convertit une date en une chaîne de caractères, en utilisant les conventions Internet GMT. Utilisez plutôt toUTCString.
toLocaleDateString
Renvoie la partie « date » de l'objet Date sous la forme d'une chaîne de caractères, en utilisant les conventions locales courantes.
toLocaleFormat
Non standard
Convertit une date en une chaîne de caractères, en utilisant une chaîne de formatage.
toLocaleString
Convertit une date en une chaîne de caractères, en utilisant les conventions locales courantes. Remplace la méthode Object.toLocaleString.
toLocaleTimeString
Renvoie la partie « heure » de l'objet Date sous la forme d'une chaîne, en utilisant les conventions locales courantes.
toSource
Non standard
Renvoie une chaîne de caractères représentant le code source pour un objet Date équivalent ; cette valeur peut être utilisée pour créer un nouvel objet. Remplace la méthode Object.prototype.toSource.
toString
Renvoie une chaîne représentant l'objet Date spécifié. Remplace la méthode Object.prototype.toString.
toTimeString
Renvoie la partie « heure » de l'objet Date sous la forme d'une chaîne de caractères lisible.
toUTCString
Convertit une date en une chaîne de caractères, en utilisant les conventions du temps universel.
valueOf
Renvoie la valeur primitive d'un objet Date. Remplace la méthode Object.prototype.valueOf.
Méthodes héritées de Object.prototype
__defineGetter__, __defineSetter__, hasOwnProperty, isPrototypeOf, __lookupGetter__, __lookupSetter__, __noSuchMethod__, propertyIsEnumerable, unwatch, watch
Exemples
Exemple : différentes manières d'assigner des dates
Les exemples qui suivent montrent différentes manières d'assigner des dates :
today = new Date();
birthday = new Date("December 17, 1995 03:24:00");
birthday = new Date(1995,11,17);
birthday = new Date(1995,11,17,3,24,0);
Exemple : calcul de temps écoulé
Les exemples suivants montrent comment déterminer le temps écoulé entre deux dates :
// utilisations de méthodes statiques
var debut = Date.now();
// l'évènement dont vous voulez mesurer la durée se place ici :
faireQuelqueChoseDeLong();
var fin = Date.now();
var intervalle = fin - debut; // temps en millisecondes
// en utilisant des objets Date
var debut = new Date();
// l'évènement dont vous voulez mesurer la durée se place ici :
faireQuelqueChoseDeLong()
var fin = new Date();
var intervalle = fin.getTime() - debut.getTime(); // temps en millisecondes

Languages