DateNN 2 IE 3 ECMA 1

L'objet Date est un objet statique qui génère des instances par le biais de différentes fonctions constructeur. Chaque instance d'un objet Date est une capture instantanée de la date et de l'heure, mesurées en millisecondes par rapport à l'heure zéro fixée au 1er janvier 1970. Les valeurs négatives en millisecondes représentent une période antérieure à cette date, les valeurs positives une période postérieure.

 

La façon habituelle d'utiliser les dates consiste à générer une nouvelle instance de l'objet Date, correspondant soit au moment présent soit à un moment (date et heure) spécifique (passé ou futur, par rapport à l'heure locale du client), puis à utiliser la multitude de méthodes de dates disponibles pour obtenir ou définir des composants de cette date (par exemple, minutes, heures, date, mois). Les navigateurs stockent une date en interne, exprimée sous forme de la valeur, en millisecondes, de l'heure du méridien de Greenwich (GMT, Greenwich Mean Time), qui coïncide avec le temps universel coordonné (UTC, Universal Tide Coordinated). Lorsque vous demandez au navigateur un composant de ce temps, il convertit automatiquement la valeur en temps local, en se basant sur le fuseau horaire et les valeurs de date et heure paramétrées au niveau du panneau de configuration de l'ordinateur client. Si ces paramètres sont incorrects, les calculs basés sur la date et l'heure risquent de l'être également.

 

Les premières versions des navigateurs prenant en charge les scripts étaient lourdement boguées en ce qui concerne l'objet Date. Pour connaître tous les détails de fonctionnement (et les bogues) de l'objet Date, reportez-vous à la documentation à l'adresse http://developer.netscape.com/viewsource/goodman_dateobject.html.

 
Propriétés
 
constructor prototype
 
Méthodes
 
getDate()getDay()getFullYear()
getHours()getMilliseconds()getMinutes()
getMonth()getSeconds()getTime()
getTimezoneOffset()getUTCDate()getUTCDay()
getUTCFullYear()getUTCHours()getUTCMilliseconds()
getUTCMinutes()getUTCMonth()getUTCSeconds()
getVarDate()getYear()parse()
setDate()setFullYear()setHours()
setMilliseconds()setMinutes()setMonth()
setSeconds()setTime()setUTCDate()
setUTCFullYear()setUTCHours()setUTCMilliseconds()
setUTCMinutes()setUTCMonth()setUTCSeconds()
setYear()toDateString()toGMTString()
toLocaleDateString()toLocaleString()toLocaleTimeString()
toString()toTimeString()toUTCString()
UTC()valueOf()
 
Création d'un objet date
 
var now = new Date();
var myDate = new Date("month dd, yyyy hh:mm:ss");
var myDate = new Date("month dd, yyyy");
var myDate = new Date(yy, mm, dd, hh, mm, ss);
var myDate = new Date(yy, mm, dd);
var myDate = new Date(milliseconds);
constructorNN 4 IE 4 ECMA 1

Lecture/écriture

Il s´agit d´une référence à la fonction qui a créé l´instance d´un objet Date: la fonction constructeur Date() d´origine dans les navigateurs.

 
Exemple
 
if (myVar.constructor == Date) {
    // process native string
}
 
Valeur

Référence de l´objet de fonction.

prototypeNN 3 IE 4 ECMA 1

Lecture/écriture

Propriété de l'objet Date statique. La propriété prototype permet d'affecter de nouvelles propriétés et méthodes aux futures instances d'une valeur Date créée dans le document considéré. Pour des exemples, voir la description de la propriété Array.prototype.

 
Exemple
 
Date.prototype.author = "DG";
 
Valeur

N´importe quelle donnée, y compris des références à des fonctions.

getDate()NN 2 IE 3 ECMA 1

Renvoie le jour du mois spécifié par une instance de l'objet Date.

 
Paramètres

Aucune.

 
Valeur renvoyée

Nombre entier entre 1 et 31.

getDay()NN 2 IE 3 ECMA 1

Renvoie un nombre entier indiquant le jour de la semaine correspondant à la date spécifiée par une instance de l'objet Date.

 
Paramètres

Aucune.

 
Valeur renvoyée

Nombre entier entre 0 et 6, dimanche correspondant à 0, lundi à 1 et ainsi de suite.

getFullYear()NN 4 IE 4 ECMA 1

Renvoie tous les chiffres de l'année correspondant à la date spécifiée par une instance de l'objet Date.

 
Paramètres

Aucune.

 
Valeur renvoyée

Nombre entier. Navigator 4 n'accepte pas de valeur inférieure à zéro. Internet Explorer et Netscape 6 renvoient des valeurs d'année négatives.

getHours()NN 2 IE 3 ECMA 1

Renvoie un nombre entier à base zéro qui indique les heures du jour correspondant à la date spécifiée par une instance de l'objet Date. Le format sur 24 heures est utilisé.

 
Paramètres

Aucune.

 
Valeur renvoyée

Nombre entier entre 0 et 23.

getMilliseconds()NN 4 IE 4 ECMA 1

Renvoie un nombre entier à base zéro indiquant le nombre de millisecondes après les secondes correspondant à la valeur spécifiée par une instance de l'objet Date.

 
Paramètres

Aucune.

 
Valeur renvoyée

Nombre entier entre 0 et 999.

getMinutes()NN 2 IE 3 ECMA 1

Renvoie un nombre entier à base zéro indiquant le nombre de minutes correspondant à valeur spécifiée par une instance de l'objet Date.

 
Paramètres

Aucune.

 
Valeur renvoyée

Nombre entier entre 0 et 59.

getMonth()NN 2 IE 3 ECMA 1

Renvoie un nombre entier à base zéro indiquant la valeur du mois correspondant à la valeur spécifiée par une instance de l'objet Date. Il n'est pas rare que les auteurs de scripts soient perturbés par le fait que les valeurs de cette méthode soient en base zéro.

 
Paramètres

Aucune.

 
Valeur renvoyée

Nombre entier compris entre 0 et 11, janvier correspondant à 0, février à 1 et ainsi de suite.

getSeconds()NN 2 IE 3 ECMA 1

Renvoie un nombre entier à base zéro indiquant les secondes, après la dernière minute écoulée, correspondant à la valeur spécifiée par une instance de l'objet Date.

 
Paramètres

Aucune.

 
Valeur renvoyée

Nombre entier entre 0 et 59.

getTime()NN 2 IE 3 ECMA 1

Renvoie un nombre entier à base zéro indiquant le nombre de millisecondes écoulées depuis le 1er janvier 1970, jusqu´à la date spécifiée par une instance de l'objet Date.

 
Paramètres

Aucune.

 
Valeur renvoyée

Nombre entier.

getTimezoneOffset()NN 2 IE 3 ECMA 1

Renvoie un nombre entier à base zéro indiquant le décalage en minutes entre l'heure GMT et l'horloge de l'ordinateur client pour une instance de l´objet Date. Les fuseaux horaires situés à l'ouest de GMT sont représentés par des valeurs positives, et les fuseaux horaires situés à l'est par des valeurs négatives. Cette méthode entraînait de nombreuses bogues dans les premières versions des navigateurs, en particulier dans les versions Macintosh.

 
Paramètres

Aucune.

 
Valeur renvoyée

Nombre entier entre -720 et 720.

getUTCDate()NN 4 IE 4 ECMA 1

Renvoie le jour du mois spécifié par une instance de l'objet Date, au format du temps GMT stocké en interne par le navigateur.

 
Paramètres

Aucune.

 
Valeur renvoyée

Nombre entier entre 1 et 31.

getUTCDay()NN 4 IE 4 ECMA 1

Renvoie un nombre entier indiquant le jour de la semaine correspondant à la valeur spécifiée par une instance de l'objet Date, au format du temps GMT stocké en interne par le navigateur.

 
Paramètres

Aucune.

 
Valeur renvoyée

Nombre entier entre 0 et 6, dimanche correspondant à 0, lundi à 1 et ainsi de suite.

getUTCFullYear()NN 4 IE 4 ECMA 1

Renvoie tous les chiffres de l'année correspondant à la valeur spécifiée par une instance de l'objet Date, au format du temps GMT stocké en interne par le navigateur.

 
Paramètres

Aucune.

 
Valeur renvoyée

Nombre entier. Navigator 4 n'accepte pas de valeur inférieure à zéro. Internet Explorer et Netscape 6 renvoient des valeurs d'année négatives.

getUTCHours()NN 4 IE 4 ECMA 1

Renvoie un nombre entier à base zéro indiquant les heures du jour correspondant à la valeur spécifiée par une instance de l'objet Date, au format du temps GMT stocké en interne par le navigateur. Le format sur 24 heures est utilisé.

 
Paramètres

Aucune.

 
Valeur renvoyée

Nombre entier entre 0 et 23.

getUTCMilliseconds()NN 4 IE 4 ECMA 1

Renvoie un nombre entier à base zéro indiquant le nombre de millisecondes après les secondes correspondant à la valeur spécifiée par une instance de l'objet Date, au format du temps GMT stocké en interne par le navigateur.

 
Paramètres

Aucune.

 
Valeur renvoyée

Nombre entier entre 0 et 999.

getUTCMinutes()NN 4 IE 4 ECMA 1

Renvoie un nombre entier à base zéro indiquant le nombre de minutes correspondant à la valeur spécifiée par une instance de l'objet Date, au format du temps GMT stocké en interne par le navigateur.

 
Paramètres

Aucune.

 
Valeur renvoyée

Nombre entier entre 0 et 59.

getUTCMonth()NN 4 IE 4 ECMA 1

Renvoie un nombre entier à base zéro indiquant le mois correspondant à la valeur spécifiée par une instance de l'objet Date, au format du temps GMT stocké en interne par le navigateur. Il n'est pas rare que les auteurs de scripts soient perturbés par le fait que les valeurs de cette méthode soient en base zéro.

 
Paramètres

Aucune.

 
Valeur renvoyée

Nombre entier compris entre 0 et 11, janvier correspondant à 0, février à 1 et ainsi de suite.

getUTCSeconds()NN 4 IE 4 ECMA 1

Renvoie un nombre entier à base zéro indiquant le nombre de secondes après la dernière minute écoulée correspondant à la valeur spécifiée par une instance de l'objet Date, au format du temps GMT stocké en interne par le navigateur.

 
Paramètres

Aucune.

 
Valeur renvoyée

Nombre entier entre 0 et 59.

getVarDate()NN s.o. IE 4 ECMA s.o.

Renvoie une valeur de date dans un format (appelé VT_DATE) approprié pour de nombreuses applications axées sur Windows, telles que les contrôles ActiveX et VBScript. Ne l´utilisez pas pour les calculs de dates JavaScript.

 
Paramètres

Aucune.

 
Valeur renvoyée

Valeur de format VT_DATE (ne l´utilisez pas pour JavaScript).

getYear()NN 2 IE 3 ECMA s.o.

Renvoie un nombre indiquant l'année pour une instance de l´objet Date, mais se comporte de façon irrégulière. En théorie, cette méthode devrait renvoyer le nombre d'années, correspondant à l'objet Date, écoulées depuis l'année 1900. Le résultat devrait afficher une valeur composée d'un ou deux chiffres pour les années comprises entre 1900 et 1999. Toutefois, ce système échoue lorsque vous atteignez l'année 2000. Au lieu d'afficher des valeurs commençant par 100, dans certains navigateurs, la méthode getYear() renvoie la même valeur à quatre chiffres que getFullYear(). Il est donc préférable d'utiliser getFullYear() autant que possible (tout en vérifiant la compatibilité du navigateur avec cette méthode). Remarque: Cette méthode n´est pas prise en charge par ECMA, alors que getFullYear() l´est.

 
Paramètres

Aucune.

 
Valeur renvoyée

Nombre entier entre 0 et 99 pour les années 1900 à 1999; nombre entier à quatre chiffres à partir de l'année 2000 pour certains navigateurs ou une continuation (100+) pour d´autres.

parse()NN 2 IE 3 ECMA 1

parse("dateString")

Méthode statique de l´objet Date qui renvoie l'équivalent en millisecondes de la date spécifiée sous forme de chaîne dans le paramètre.

 
Paramètres
 
  • Tout format de chaîne valide correspondant à celui provenant d'un objet Date. Pour obtenir des exemples de formats, voir les méthodes toString(), toGMTString() et toLocaleString().
 
Valeur renvoyée

Date en millisecondes.

setDate()NN 2 IE 3 ECMA 1

setDate(entierDate)

Renvoie le jour du mois spécifié pour une instance de l'objet Date. Si vous spécifiez une date ultérieure à la fin du mois courant de l´objet, ce dernier recalcule la date dans le mois suivant. Par exemple, si un objet Date est défini sur le 25 décembre 2002, vous pouvez calculer quelle sera la date 10 jours plus tard avec la construction suivante:

 

Après ce calcul, la valeur de myDate est l´équivalent du 4 janvier 2003.

 
Paramètres
 
  • Date sous la forme d´un nombre entier.
 
Valeur renvoyée

Nouvelle date en millisecondes.

setFullYear()NN 4 IE 4 ECMA 1

setFullYear(entierAnnée)

Affecte l'année pour une instance de l'objet Date.

 
Paramètres
 
  • Nombre entier. Navigator 4 n'accepte pas de chiffres inférieurs à zéro. Internet Explorer et NN 6 renvoient des valeurs d'année négatives.
 
Valeur renvoyée

Nouvelle date en millisecondes.

setHours()NN 2 IE 3 ECMA 1

setHours(entierHeure)

Renvoie l´heure de la journée pour une instance de l'objet Date. Le format sur 24 heures est utilisé. Si vous spécifiez une heure ultérieure à la fin de la journée considérée de l´objet, l´objet recalcule l´heure dans la ou les journées suivantes.

 
Paramètres
 
  • Nombre entier à base zéro.
 
Valeur renvoyée

Nouvelle date en millisecondes.

setMilliseconds()NN 4 IE 4 ECMA 1

setMilliseconds(entierMillisecondes)

Définit le nombre de millisecondes après les secondes pour une instance de l'objet Date.

 
Paramètres
 
  • Nombre entier, à base zéro, de millisecondes.
 
Valeur renvoyée

Nouvelle date en millisecondes.

setMinutes()NN 2 IE 3 ECMA 1

setMinutes(entierMinute)

Définit les minutes correspondant à la valeur pour une instance de l'objet Date.

 
Paramètres
 
  • Nombre entier à base zéro.
 
Valeur renvoyée

Nouvelle date en millisecondes.

setMonth()NN 2 IE 3 ECMA 1

setMonth(entierMois)

Définit les mois correspondant à la valeur pour une instance de l'objet Date. Il n'est pas rare que les auteurs de scripts soient perturbés par le fait que les valeurs de cette méthode soient en base zéro.

 
Paramètres
 
  • Nombre entier à base zéro. Janvier est 0, février 1, et ainsi de suite. L´affectation de valeurs supérieures fait passer l´objet à l´année suivante.
 
Valeur renvoyée

Nouvelle date en millisecondes.

setSeconds()NN 2 IE 3 ECMA 1

setSeconds(entierSeconde)

Définit les secondes après la dernière minute écoulée correspondant à la valeur spécifiée pour une instance de l'objet Date.

 
Paramètres
 
  • Nombre entier à base zéro.
 
Valeur renvoyée

Nouvelle date en millisecondes.

setTime()NN 2 IE 3 ECMA 1

setTime(entierMillisecondes)

Définit une instance de l´objet Date sur le nombre de millisecondes depuis le 1er janvier 1970.

 
Paramètres
 
  • Nombre entier de millisecondes.
 
Valeur renvoyée

Nouvelle date en millisecondes.

setUTCDate()NN 4 IE 4 ECMA 1

setUTCDate(entierDate)

Renvoie le jour du mois d´une instance de l'objet Date, au format du temps GMT stocké en interne par le navigateur. Si vous spécifiez une date ultérieure à la fin du mois considéré de l´objet, ce dernier recalcule la date dans le mois suivant.

 
Paramètres
 
  • Nombre entier.
 
Valeur renvoyée

Nouvelle date GMT en millisecondes.

setUTCFullYear()NN 4 IE 4 ECMA 1

setUTCFullYear(entierAnnée)

Définit tous les chiffres de l'année correspondant pour une instance de l'objet Date, au format du temps GMT stocké en interne par le navigateur.

 
Paramètres
 
  • Nombre entier. Navigator 4 n'accepte pas de valeurs inférieures à zéro. Internet Explorer et NN 6 renvoient des valeurs d'année négatives.
 
Valeur renvoyée

Nouvelle date GMT en millisecondes.

setUTCHours()NN 4 IE 4 ECMA 1

setUTCHours(entierHeure)

Définit les heures de la journée pour une instance de l'objet Date, au format du temps GMT stocké en interne par le navigateur. Le format sur 24 heures est utilisé.

 
Paramètres
 
  • Nombre entier à base zéro.
 
Valeur renvoyée

Nouvelle date GMT en millisecondes.

setUTCMilliseconds()NN 4 IE 4 ECMA 1

setUTCMilliseconds(entierMillisecondes)

Définit le nombre de millisecondes après les secondes d´une instance de l'objet Date, au format du temps GMT stocké en interne par le navigateur.

 
Paramètres
 
  • Nombre entier à base zéro.
 
Valeur renvoyée

Nouvelle date GMT en millisecondes.

setUTCMinutes()NN 4 IE 4 ECMA 1

setUTCMinutes(entierMinute)

Définit les minutes de l´heure et de la journée pour une instance de l'objet Date, au format du temps GMT stocké en interne par le navigateur.

 
Paramètres
 
  • Nombre entier à base zéro.
 
Valeur renvoyée

Nouvelle date GMT en millisecondes.

setUTCMonth()NN 4 IE 4 ECMA 1

setUTCMonth(entierMois)

Définit le mois pour une instance de l'objet Date, au format du temps GMT stocké en interne par le navigateur Il n'est pas rare que les auteurs de scripts soient perturbés par le fait que les valeurs de cette méthode soient en base zéro.

 
Paramètres
 
  • Nombre entier à base zéro. Janvier est 0, février 1, et ainsi de suite. L´affectation de valeurs supérieures fait passer l´objet à l´année suivante.
 
Valeur renvoyée

Nouvelle date GMT en millisecondes.

setUTCSeconds()NN 4 IE 4 ECMA 1

setUTCSeconds(entierSeconde)

Définit les secondes après la dernière seconde écoulée pour une instance de l'objet Date, au format du temps GMT stocké en interne par le navigateur

 
Paramètres
 
  • Nombre entier à base zéro.
 
Valeur renvoyée

Nouvelle date GMT en millisecondes.

setYear()NN 2 IE 3 ECMA s.o.

setYear(entierAnnée)

Définit l'année d´une instance de l'objet Date. Utilisez setFullYear() si votre version de navigateur le permet. Remarque: Cette méthode n´est pas prise en charge par ECMA, alors que setFullYear() l´est.

 
Paramètres
 
  • Nombres entiers de quatre (et parfois deux) chiffres représentant une année.
 
Valeur renvoyée

Nouvelle date en millisecondes.

toDateString()NN 6 IE 5.5(Win) ECMA 3

Renvoie une chaîne composée seulement de la portion de la date d´une instance de l'objet Date. Le format exact dépend du navigateur et de la langue, mais les versions en anglais américain de Microsoft Internet Explorer 6 pour Windows et Netscape 6 renvoient les valeurs au format Jjj Mmm jj aaaa.

 
Paramètres

Aucune.

 
Valeur renvoyée

Chaîne.

toGMTString()NN 2 IE 3 ECMA 1

Renvoie une version sous forme de chaîne de la valeur GMT d'une instance de l'objet Date, dans un format normalisé. Cette méthode ne modifie pas l'objet Date original. Dans les navigateurs plus récents, l'utilisation de la méthode toUTCString() est recommandée par rapport à la méthode toGMTString().

 
Paramètres

Aucune.

 
Valeur renvoyée

Chaîne au format suivant: , jj mmm aaaa hh:mm:ss GMT. Par exemple:

 
Mon 05 Aug 2002 02:33:22 GMT
toLocaleDateString()NN 6 IE 5.5(Win) ECMA 3

Renvoie une chaîne composée seulement de la portion de la date d´une instance de l'objet Date. Le format exact dépend du navigateur et de la langue. IE 6 pour Windows renvoie une valeur au format , jj, aaaa; Netscape 6 renvoie ...jj aaaa

 
Paramètres

Aucune.

 
Valeur renvoyée

Chaîne.

toLocaleString()NN 2 IE 3 ECMA 1

Renvoie une chaîne composée de la valeur de fuseau horaire local de la date et de l´heure d´une instance de l'objet Date. Le format peut être localisé pour un pays particulier ou pour les conventions du système d´exploitation.

 
Paramètres

Aucune.

 
Valeur renvoyée

Chaîne sous de multiples formats. Exemples des versions françaises des navigateurs:

 
Plate-formeValeur de chaîne
Internet Explorer 6/Win32 Tuesday, April 01, 2003 7:30:00 AM
Internet Explorer 5.1 pour Mac Tuesday, 01 April, 2003 07:30:00 AM
Navigator 6/Win32 Tuesday, April 01, 2003 07:30:00
Navigator 6 pour Mac Tuesday April 01 07:30:00 2003
toLocaleTimeString()NN 6 IE 5.5(Win) ECMA 3

Renvoie une chaîne composée seulement de la portion de l´heure d´une instance de l'objet Date. Le format exact dépend du navigateur et de la langue. IE 6 pour Windows renvoie une valeur au format [h]h:mm:ss xM; Netscape 6 renvoie hh:mm:ss.

 
Paramètres

Aucune.

 
Valeur renvoyée

Chaîne.

toString()NN 2 IE 4 ECMA 1

Méthode utilisée essentiellement par le navigateur pour convertir une instance de l´objet Date en valeur sous forme de chaîne lorsque c´est nécessaire pour l'affichage dans des boîtes de dialogue ou les affichages écran.

 
Paramètres

Aucune.

 
Valeur renvoyée

Chaîne sous de multiples formats. Exemples de versions françaises des navigateurs:

 
Plate-formeValeur de chaîne
Internet Explorer 6/Win32 Tue Apr 1 07:30:00 PST 2003
Internet Explorer 5.1 pour Mac Tue Apr 1 07:30:00 PST 2003
Navigator 6/Win32 Tue Apr 01 07:30:00 GMT-0800 (Pacific Standard Time) 2003
Navigator 6 pour Mac Tue Apr 01 2003 07:30:00 GMT-0800
toTimeString()NN 6 IE 5.5(Win) ECMA 3

Renvoie une chaîne composée seulement de la portion de l´heure d´une instance de l'objet Date. Le format exact dépend du navigateur et de la langue.

 
Paramètres

Aucune.

 
Valeur renvoyée

Chaîne.

toUTCString()NN 4 IE 4 ECMA 1

Renvoie une version sous forme de chaîne de la valeur GMT d'une instance de l'objet Date, dans un format normalisé. Cette méthode ne modifie pas l'objet Date original. Dans les navigateurs plus récents, l'utilisation de la méthode toUTCString() est recommandée par rapport à la méthode toGMTString().

 
Paramètres

Aucune.

 
Valeur renvoyée

Chaîne au format suivant: dayAbbrev jj mmm aaaa hh:mm:ss GMT. Par exemple:

 
Mon 05 Aug 2002 02:33:22 GMT
UTC()NN 2 IE 3 ECMA 1

UTC(aaaa, mm, jj[, hh[, mm[, ss[, millisecondes]]]])

Méthode statique de l'objet Date qui renvoie une version numérique de la date stockée en interne par le navigateur pour un objet Date. Contrairement aux paramètres applicables au constructeur d'objet Date, les paramètres applicables à la méthode UTC() doivent être au format GMT pour que la valeur renvoyée soit correcte. Cette méthode ne génère pas d'objet date, contrairement au constructeur d'objet Date.

 
Paramètres
 
  • Valeur de l'année composée de quatre chiffres.
  • Numéro du mois composé de deux chiffres (0-11).
  • Numéro du jour composé de deux chiffres (1-31).
  • Nombrefacultatif à deux chiffres indiquant les heures au format sur 24 heures (0-23).
  • Nombre facultatif à deux chiffres indiquant les minutes (0-59).
  • Nombre facultatif à deux chiffres indiquant les secondes (0-59).
  • Nombre facultatif à trois chiffres indiquant les millisecondes après la dernière seconde écoulée (0-999).
 
Valeur renvoyée

Nombre entier exprimant la valeur GMT, en millisecondes, de la date spécifiée sous forme de paramètres.

valueOf()NN 4 IE 4 ECMA 1

Renvoie la valeur de l'objet.

 
Paramètres

Aucune.

 
Valeur renvoyée

Nombre entier de millisecondes.