Date | NN 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);

constructor | NN 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.

prototype | NN 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-forme | Valeur 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-forme | Valeur 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.