 |
|
 |
 |
 |
 |
  | 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
|
 |
 |
|


 |
 |
 |