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 | ||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||
Méthodes | ||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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 | |
|
|
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: |
||||||||||
|
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: |
||||||||||
|
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 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. |