Comment Ca Marche - Communauté informatique  
   
Accueil - Encyclopédie informatiqueTélécharger l'encyclopédieContribuer à cet article

Javascript - L'objet Date

L'objet date de Javascript Encyclopédie


Les particularités de l'objet Date

L'objet Date permet de travailler avec toutes les variables qui concernent les dates et la gestion du temps. Il s'agit d'un objet inclus de façon native dans Javascript, et que l'on peut toujours utiliser.

La syntaxe pour créer un objet-date peut être une des suivantes :

  1. Nom_de_l_objet = new Date()
    cette syntaxe permet de stocker la date et l'heure actuelle
  2. Nom_de_l_objet = new Date("jour, mois date année heures:minutes:secondes")
    les paramètres sont une chaîne de caractère suivant scrupuleusement la notation ci-dessus
  3. Nom_de_l_objet = new Date(année, mois, jour)
    les paramètres sont trois entiers séparés par des virgules.
    Les paramètres omis sont mis à zéro par défaut
  4. Nom_de_l_objet = new Date(année, mois, jour, heures, minutes, secondes[, millisecondes])
    les paramètres sont six entiers séparés par des virgules.
    Les paramètres omis sont mis à zéro par défaut

Les dates en Javascript sont stockées de la même manière que dans le langage Java, c'est-à-dire qu'il s'agit du nombre de millisecondes depuis le 1er janvier 1970. Ainsi, toute date antérieure au 1er janvier 1970 fournira une valeur erronée.

Avec les versions de Javascript inférieures à la version 1.3, pour manipuler des dates antérieures à "l'année zéro" il vous sera nécessaire de créer un objet date spécifique.
A partir de la version 1.3, il est possible de manipuler des dates de plus ou mois 100 000 000 de jours par rapport au premier janvier 1970.

Les méthodes de l'objet Date

La date est stockée dans une variable sous la forme d'une chaîne qui contient le jour, le mois, l'année, l'heure, les minutes, et les secondes. Il est donc difficile d'accéder à un seul élément d'un objet date avec les fonctions de manipulation de chaînes de caractères, étant donné que chacun des éléments peut avoir une taille variable. Heureusement, les méthodes de l'objet Date fournissent un moyen simple d'accéder à un seul élément, ou bien de le modifier.
Leur syntaxe est la suivante :

Objet_Date.Methode()

Connaître la date

Les méthodes dont le nom commence par le radical get (mot anglais qui signifie récupérer) permettent de renvoyer une partie de l'objet Date :

Méthode Description Type de valeurs retournée
getDate() Permet de récupérer la valeur du jour du mois L'objet retourné est un entier (entre 1 et 31) qui correspond au jour du mois :
getDay() Permet de récupérer la valeur du jour de la semaine pour la date spécifiée L'objet retourné est un entier qui correspond au jour de la semaine :
  • 0: dimanche
  • 1: lundi ...
getFullYear() Permet de récupérer la valeur de l'anné sur 4 chiffres pour la date passée en paramètre L'objet retourné est un entier qui correspond à l'année (XXXX) :
getHours() Permet de récupérer la valeur de l'heure L'objet retourné est un entier (entre 0 et 23) qui correspond à l'objet Date.
getMilliseconds() Permet de récupérer le nombre de millisecondes L'objet retourné est un entier (entre 0 et 999) qui correspond aux millisecondes de l'objet passé en paramètre.
getMinutes() Permet de récupérer la valeur des minutes L'objet retourné est un entier (entre 0 et 59) qui correspond aux minutes de l'objet Date.
getMonth() Permet de récupérer le numéro du mois L'objet retourné est un entier (entre 0 et 11) qui correspond au mois :
  • 0: janvier
  • 1: février ...
getSeconds() Permet de récupérer le nombre de secondes L'objet retourné est un entier (entre 0 et 59) qui correspond aux secondes de l'objet passé en paramètre.
getTime() Permet de récupérer le nombre de millisecondes depuis le 1er janvier 1970 L'objet retourné est un entier. Cette méthode est très utile pour convertir des dates, soustraire ou ajouter deux dates, etc.
getTimezoneOffset() Retourne la différence entre l'heure locale et l'heure GMT (Greenwich Mean Time) L'objet retourné est un entier, il représente le nombre de minutes de décalage
getYear() Permet de récupérer la valeur de l'anné sur 2 chiffres pour l'objet Date. L'objet retourné est un entier qui correspond à l'anné (XX) :

Modifier le format de la date

Les deux méthodes suivantes ne permettent de travailler que sur l'heure actuelle (objet Date()) leur syntaxe est donc figée :

Méthode Description Type de valeurs retournée
toGMTString() Permet de convertir une date en une chaîne de caractères au format GMT L'objet retourné est une chaîne de caractère du type :
Wed, 28 Jul 1999 15:15:20 GMT
toLocaleString() Permet de convertir une date en une chaîne de carctères au format local L'objet retourné est une chaîne de caractère dont la syntaxe dépend du système, par exemple :
28/07/99 15:15:20

Modifier la date

Les méthodes dont le nom commence par le radical set (mot anglais qui signifie règler) permettent de modifier une valeur :

Méthode Description Type de valeur en paramètre
setDate(X) Permet de fixer la valeur du jour du mois Le paramètre est un entier (entre 1 et 31) qui correspond au jour du mois
setDay(X) Permet de fixer la valeur du jour de la semaine Le paramètre est un entier qui correspond au jour de la semaine :
  • 0: dimanche
  • 1: lundi ...
setHours(X) Permet de fixer la valeur de l'heure Le paramètre est un entier (entre 0 et 23) qui correspond à l'heure
setMinutes(X) Permet de fixer la valeur des minutes Le paramètre est un entier (entre 0 et 59) qui correspond aux minutes
setMonth(X) Permet de fixer le numéro du mois Le paramètre est un entier (entre 0 et 11) qui correspond au mois :
  • 0: janvier
  • 1: février ...
setTime(X) Permet d'assigner la date Le paramètre est un entier représentant le nombre de millisecondes depuis le 1er janvier 1970

Trucs & astuces pertinents trouvés dans la base de connaissances

05/11 11h53 Date de dernière modification de la page (Javascript)
12/02 01h50 convertisseur d'unités de mesures scientifiques (Javascript)
19/11 00h08 Effacer un champ de formulaire lors du clic (focus) (Javascript)
18/11 00h43 JavaScript c'est la même chose que Java (Mythes et légendes)
11/11 01h39 Coloration syntaxique dans vos pages web (Webmaster)
22/08 16h19 Ajouter une date fixe dans une cellule en 2 touches (Excel)
04/11 16h32 Interdire le clic droit de la souris (Javascript)
06/04 21h53 Date de dernière modification (PHP)
08/11 10h32 Lien aléatoire / Choisir un lien au hasard (Javascript)
Javascript date Plus d'astuces sur « Javascript date »

Discussions pertinentes trouvées dans le forum

05/01 13h52 php javascript date obtenir âge [php/javascript][Date] Comment obtenir l'âge Développement 01/03 11h44->fenix5115
19/12 11h53 javascript convertir date comparer [JAVASCRIPT] convertir une date et comparer Développement 01/02 13h48->Maxkater5
06/06 10h44 javascript php vérifier date [javascript,php] vérifier une date Développement 07/06 11h43->griese1
16/06 09h41 date javascript php Date Javascript ... php ... ?!?!!! Webmastering 16/06 14h12->layork15
07/08 11h13 info javascript date français ***INFO***JavaScript: date en Français Windows 09/08 01h06->ipl5
19/04 16h53 verification date javascript verification date en javascript (urgent) Windows 22/04 10h18->Peguinette4
26/01 18h09 comparaison date php javascript Comparaison de date (PHP, Javascript) Webmastering 14/02 19h40->jlfond4
31/03 20h00 javascript date [javascript] Date() Développement 04/04 11h18->kciop4
15/11 12h07 javascript split date Javascript : Split et Date Windows 15/11 18h15->ZIG12
09/12 08h02 javascript recuparer date heure fichier Javascript:recuparer date heure d un fichier Windows 09/12 21h19->Bobinours2
Discussion fermée Problème résolu Javascript date Plus de discussions sur « Javascript date »

Ce document intitulé « Javascript - L'objet Date » issu de l'encyclopédie informatique Comment Ça Marche (www.commentcamarche.net) est mis à disposition sous les termes de la licence Creative Commons. Vous pouvez copier, modifier des copies de cette page, dans les conditions fixées par la licence, tant que cette note apparaît clairement.