Date

Sommaire

Créé des instances Date qui vous permettent de travailler avec les dates et les heures.

Syntaxe

new Date()
new Date(milliseconds)
new Date(dateString)
new Date(year, month, day [, hour, minute, second, millisecond ])
Note: Notez que les objets Date ne peuvent être instancié en appelant la Date ou en l'utilisant comme un constructeur; contrairement à d'autres types d'objets JavaScript, les objets n'ont pas de  syntaxe littérale de Date.

Paramètres

milliseconds
Valeur d'un entier représentant le nombre de millisecondes depuis le 1 Janvier 1970 00:00:00 UTC (Unix Epoch).
dateString
Valeur de chaîne représentant une date. La chaîne doit être dans un format reconnu par la méthode parse (IETF-compliant RFC 1123 timestamps).
year
IValeur d'un entier représentant l'annéer. Pour la compatibilité (afin d'éviter le problème de Y2K), vous pouvez toujours spécifier l'année en entietr; Utilisez plutôt 1998, que 98.
month
Valeur d'un entier représentant le mois, commençant à partir de  0 pour Janvier jusqu'à 11 pour Décembre.
day
Valeur d'un entier représentant d'un jour du mois (1-31).
hour
Valeur d'un entier représentant l'heure d'un jour (0-23).
minute
Valeur d'un entier représentant le segment de minute (0-59) du temps lu.
second
Valeur d'un entier représentant le segment de secondes (0-59) du temps lu.
millisecond
Valeur d'un entier représentant le segment de millisecondes (0-999) du temps lu.

Description

Si vous ne fournissez pas d'arguments, le constructeur crée un objet Date pour la date du jour et l'heure selon l'heure locale. Si vous fournissez des arguments mais pas les autres, les arguments manquants sont mis à 0. Si vous fournissez des arguments, vous devez fournir au moins l'année, le mois et le jour. Vous pouvez omettre les heures, minutes, secondes et millisecondes.

La date est mesuré en millisecondes depuis minuit le 01 Janvier 1970 UTC. Une journée détient 86.400.000 millisecondes. La gamme objet Date est -100000000 jours à 100.000.000 jours par rapport au 01 Janvier 1970 UTC.

L'objet Date fournit un comportement uniforme à travers les plates-formes.

L'objet Date soutient un certain nombre de méthodes UTC (Universal), ainsi que des méthodes d'heure locale. UTC, également connu sous le nom de Greenwich Mean Time (GMT), se réfère au temps fixé par la norme de temps du monde (World Time Standard). L'heure locale est l'heure connue sur l'ordinateur quand JavaScript est exécuté.

L'invocation de Date dans un contexte non-constructeur (ie, sans l'opérateur new) renverra une chaîne représentant l'heure courante.

Propriétés

Pour les propriétés disponibles sur les instances Date, vir Propriétés des instances de Date.

prototype
Permet l'ajout de propriétés à un objet Date.

 

Propriétés héritées par Function:
arity, caller, constructor, length, name

Méthodes

Pour les méthodes disponibles sur les instances Date, voir les Méthodes des instances de Date.

now
Retourne la valeur numérique correspondant au temps courant.
parse
Analyse la représentation d'une chaîne de la date, et retourne le nombre de millisecondes depuis Janvier 1, 1970, 00:00:00, Heure locale.
UTC
Accepte les mêmes paramètres sous la forme la plus longue du constructeur, et retourne le nombre de millisecondes dans l'objet Date depuis Janvier 1, 1970, 00:00:00, universal time.

 

Méthodes héritées depuis Function:
apply, call, toSource, toString

Instances Date

Les instances Date  héritées depuis Date.prototype . Vous pouvez mofifier le prototype du constructeur d'obejet pour affecter les propriétés et les méthodees héritées par les instances Date.

Pour la compatibilité avec les milliers de calculs (en d'autres termes, pour tenir compte de l'année 2000), vous pourrez toujours spécifier l'année en entier; par exemple, utilisez 1998, et non pas 98. Pour vous aider dans spécification de l'année complète l'année, JavaScript inclut les méthodes getFullYear, setFullYear, getUTCFullYear, et setUTCFullYear.

Propriétés

constructor
Retourne la fonction qui créé une instance. C'est le constructeur Date par défaut.
Propriétés héritées depuis Object:
__parent__, __proto__

Méthodes

getDate
Retourne le jour  du mois (1-31) pour la date spécifiée en accord avec l'heure locale.
getDay
Retourne le jour de la semaine (0-6) pour la date spécifiée en accord avec l'heure locale.
getFullYear
Retourne l'année (4 digits for 4-digit years) pour la date spécifiée en accord avec l'heure locale.
getHours
Retourne l'heure (0-23) pour la date spécifiée en accord avec l'heure locale.
getMilliseconds
Retourne les millisecondes (0-999) pour la date spécifiée en accord avec l'heure locale.
getMinutes
Retourne les minutes (0-59) pour la date spécifiée en accord avec l'heure locale.
getMonth
Retourne le mois (0-11) pour la date spécifiée en accord avec l'heure locale.
getSeconds
Retourne les secondes (0-59) pour la date spécifiée en accord avec l'heure locale.
getTime
Retourne la valeur numérique de la date spécifiée comme le nombre de millisecondes depuis Janvier 1, 1970, 00:00:00 UTC (négatives pour les temps antérieurs).
getTimezoneOffset
Retourne le décalage de fuseau horaire en minutes pour la localisation en cours.
getUTCDate
Retourne le jour (date) et le mois (1-31) pour la date spécifiée en accord avec l'heure universelle.
getUTCDay
Retourne le jour de la semaine (0-6) pour la date spécifiée en accord avec l'heure universelle.
getUTCFullYear
Retourne l'année (4 digits for 4-digit years) pour la date spécifiée en accord avec l'heure universelle.
getUTCHours
Retourne les heures (0-23) pour la date spécifiée en accord avec l'heure universelle.
getUTCMilliseconds
Retourne les millisecondes (0-999) pour la date spécifiée en accord avec l'heure universelle.
getUTCMinutes
Retourne les minutes (0-59) pour la date spécifiée en accord avec l'heure universelle.
getUTCMonth
Retourne le mois (0-11) pour la date spécifiée en accord avec l'heure universelle.
getUTCSeconds
Retourne les secondes (0-59) pour la date spécifiée en accord avec l'heure universelle.
getYear
Deprecated
Retourne l'année (habituellement en  2-3 digits) dans la date spécifiée pour l'heure locale. Utilisez getFullYear à la place.
setDate
Définit le jour du mois (1-31) pour la date spécifiée en accord avec l'heure locale.
setFullYear
Définit l'année entière (4 digits pour 4-digit années) pour la date spécifiée en accord avec l'heure locale.
setHours
Définit les heures (0-23) pour la date spécifiée en accord avec l'heure locale.
setMilliseconds
Définit les millisecondes (0-999) pour la date spécifiée en accord avec l'heure locale.
setMinutes
Définit les minutes (0-59) pour la date spécifiée en accord avec l'heure locale.
setMonth
Définit le mois (0-11) pour la date spécifiée en accord avec l'heure locale.
setSeconds
Définit les secondes (0-59) pour la date spécifiée en accord avec l'heure locale.
setTime
Définit l'objet Date pour le temps représenté par le nombre de millisecondes depuis Janvier 1, 1970, 00:00:00 UTC, permettant des nombres négatifs pour les temps antérieurs.
setUTCDate
Sets the day of the month (1-31) pour la date spécifiée en accord avec l'heure universelle.
setUTCFullYear
Définit l'année entière (4 digits pour 4-digit années) pour la date spécifiée en accord avec l'heure universelle.
setUTCHours
Définit les heures (0-23) pour la date spécifiée en accord avec l'heure universelle.
setUTCMilliseconds
Définit les millisecondes (0-999) pour la date spécifiée en accord avec l'heure universelle.
setUTCMinutes
Définit les minutes (0-59) pour la date spécifiée en accord avec l'heure universelle.
setUTCMonth
Définit le mois (0-11) pour la date spécifiée en accord avec l'heure universelle.
setUTCSeconds
Sets the seconds (0-59) pour la date spécifiée en accord avec l'heure universelle.
setYear
Deprecated
Définit l'année (habituellement 2-3 digits) pour la date spécifiée en accord avec l'heure locale. Utilisez setFullYear à la place.
toDateString
Retourne une portion de "date" de la date comme une chaîne lisible par l'homme.
toISOString
Convertit une date en une chaîne suivant le Format ISO 8601 Étendu.
toJSON Requires JavaScript 1.8.5
Retourne une cqhaîne encapsulant l'objet Date dans le format JSON.
toGMTString
Deprecated
Convertit une date en une chaîne, utilisant les conventions Internet GMT. Utilisez toUTCString à la place.
toLocaleDateString
Retourne une portion de "date" de Date comme une chaîne, utilisant les conventions courantes locales.
toLocaleFormat
Non-standard
Convertit une date en une chaîne, utilisant un format chaîne.
toLocaleString
Convertit une date en une chaîne, utilisant les conventions courantes locales. Substitue la méthode Object.toLocaleString.
toLocaleTimeString
Retourne la portion de "time" de Date comme une chaîne, utilisant les conventions courantes locales.
toSource
Non-standard
Retourne la chaîne représentant la source pour un objet équivalent Date; vous pouvez utiliser la valeur pour créer un nouvel objet. Substitue la méthode Object.prototype.toSource.
toString
Retourne la chaîne représentant l'objet Date spécifié. Substitue la méthode Object.prototype.toString.
toTimeString
Retourne le "time" de la date comme une chaîne lisible par l'homme.
toUTCString
Convertit des dates en une chaîne, utilisant les conventions courantes universelles.
valueOf
Retourne la valeur primitive de l'objet Date. Substitue la méthode Object.prototype.valueOf.

Exemples

Exemple: Several ways to assign dates

Les exemples suivants montrent beaucoup de pistes pour 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);

Example: Calculating elapsed time

Les exemples suivants montrent comment déterminer le temps écoulé entre deux dates:

    var start = Date.now();  
      
    doSomethingForALongTime();  
    var end = Date.now();  
    var elapsed = end - start; 
    

 

    var start = new Date();  
      
    doSomethingForALongTime();  
    var end = new Date();  
    var elapsed = end.getTime() - start.getTime();
    

 

    function printElapsedTime (fTest) {  
        var nStartTime = Date.now(), vReturn = fTest(), nEndTime = Date.now();  
        alert("Elapsed time: " + String(nEndTime - nStartTime) + " milliseconds");  
        return vReturn;  
    }  
      
    yourFunctionReturn = printElapsedTime(yourFunction);

Exemple: ISO 8601 dates formatées

Date.toISOString()est maintenant supportée, aussi vous pouvez l'utiliser.

L'exemple suivant démontre comment formater manuellement une date, dans un format ISO 8601 utilisant UTC:

/* use a function for the exact format desired... */
function ISODateString(d){
  function pad(n){return n<10 ? '0'+n : n}
  return d.getUTCFullYear()+'-'
      + pad(d.getUTCMonth()+1)+'-'
      + pad(d.getUTCDate())+'T'
      + pad(d.getUTCHours())+':'
      + pad(d.getUTCMinutes())+':'
      + pad(d.getUTCSeconds())+'Z'
}

var d = new Date();
console.log(ISODateString(d)); // prints something like 2009-09-28T19:03:12Z

Compatibilité des navigateurs

 

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support ? (Supporté) ? ? ?

 

Étiquettes et contributeurs liés au document

Contributeurs ayant participé à cette page : daniel35310, LaBoumerde
Dernière mise à jour par : LaBoumerde,