Objet Date


Cet objet permet à l’usager d'ajuster la date et l’heure.

Syntaxe

Pour créer un objet "Date":
  1. NomObjetDate = new Date()
  2. NomObjetDate = new Date("journée du mois, année heures:minutes:secondes")
  3. NomObjetDate = new Date(année, mois, journée)
  4. NomObjetDate = new Date(année, mois, journée, heures, minutes, secondes)

NomObjetDate est soit le nom d’un nouvel objet ou la propriété d’un objet existant.

année, mois, journée, heures, minutes et secondes sont des chaînes de caractères pour les points 1 et 2. Pour 3 et 4, ils sont des nombres entiers.

Pour utiliser l’objet "Date":

NomObjetDate.nomMéthode(paramètres)
nomMéthode est l'une des méthodes utilisé avec l'objet.

Exceptions:
Les méthodes “parse” et “UTC” doivent être utilisées de la façon suivante:

Date.parse(paramètres)
Date.UTC(paramètres)

Propriété

getDate()			(>JavaScript1.0, JScript1.0)
getHours()			(>JavaScript1.0, JScript1.0)
getMonth()			(>JavaScript1.0, JScript1.0)
getTime()			(>JavaScript1.0, JScript1.0)
getYear()			(>JavaScript1.0, JScript1.0)
setDate(valeurDate)		(>JavaScript1.0, JScript1.0)
setMinutes(valeurMinute)	(>JavaScript1.0, JScript1.0)
setSeconds(valeurSeconde)	(>JavaScript1.0, JScript1.0)
setYear(valeurAnnee)		(>JavaScript1.0, JScript1.0)
toLocaleString()		(>JavaScript1.0, JScript1.0)

function AfficheHeure()
{
	Today = new Date()
	document.write(Today.getHours() + "h" + Today.getMinutes() )
}
AfficheHeure()
</SCRIPT>

prototype

Cette propriété définit une propriété qui est partagée par tous les objets d'un type spécifié. Il faut utiliser cette propriété pour ajouter des propriétés aux objets créés avec l'opérateur "new".
Permet d'ajouter une propriété à l'objet "Date"

Syntaxe

typeObjet.prototype.nomPropriété = valeur

typeObjet est le nom d'un constructeur spécifié par le type de l'objet.
nomPropriété est le nom de la propriété qui devra être créée.
valeur est la valeur initiale de la propriété pour tous les objets du typeObjet spécifié.


getDate()

Cette méthode retourne le jour du mois pour une date spécifiée. La valeur retournée est un entier entre 1 et 31.

Syntaxe

JavaScript1.0 : nomObjetdate.getDate()

nomObjetdate est soit le nom d’un objet date ou une propriété d’un objet existant.

Exemple

<SCRIPT language="JavaScript">
// retourne le jour du mois :
aujourdhui = new Date();
jourmois = aujourdhui.getDate()
document.write("nous sommes le "+jourmois+" jour de ce mois<BR>");
</SCRIPT>

getDay()

Cette méthode retourne le jour de la semaine pour une date spécifiée. La valeur retournée est un entier correspondant à une journée de la semaine, où zéro représente dimanche et six représente samedi.

Syntaxe

JavaScript1.0 : nomObjetdate.getDay()

nomObjetdate est soit le nom d’un objet date ou une propriété d’un objet existant.

Exemple

<SCRIPT language="JavaScript">
// retourne le jour de la semaine pour une date spécifiée (0= Dimanche):
aujourdhui = new Date();
joursemaine = aujourdhui.getDay()
document.write("C'est le "+joursemaine+" jour de la semaine
	(0 = dimanche, 6 = samedi)<BR>");
</SCRIPT>

getHours()

Cette méthode retourne l’heure pour une heure spécifiée. La valeur retournée est un entier entre 0 et 23.

Syntaxe

JavaScript1.0 : nomObjetdate.getHours()

nomObjetdate est soit le nom d’un objet date ou une propriété d’un objet existant.

Exemple

<SCRIPT language="JavaScript">
// Récupère l'heure :
aujourdhui = new Date();
heure = aujourdhui.getHours()
document.write("c'est la "+heure+" heure de la journée<BR>");
</SCRIPT>

getMinutes()

Cette méthode retourne les minutes pour une heure spécifiée. La valeur retournée est un entier entre 0 et 59.

Syntaxe

JavaScript1.0 : nomObjetdate.getMinutes()

nomObjetdate est soit le nom d’un objet date ou une propriété d’un objet existant.

Exemple

<SCRIPT language="JavaScript">
// Récupère les minutes :
aujourdhui = new Date();
minute = aujourdhui.getMinutes()
document.write("c'est la "+minute+" minute de cette heure<BR>");
</SCRIPT>

getMonth()

Cette méthode retourne le mois pour une date spécifiée. La valeur retournée est un entier entre 0 et 11, où zéro représente janvier et 11 représente décembre.

Syntaxe

JavaScript1.0 : nomObjetdate.getMonth()

nomObjetdate est soit le nom d’un objet date ou une propriété d’un objet existant.

Exemple

<SCRIPT language="JavaScript">
// Récupère le mois :
aujourdhui = new Date();
mois = aujourdhui.getMonth()
document.write("c'est le "+mois+" mois de cette année
	(Attention : comptés de 0 à 11)<BR>");
</SCRIPT>

getSeconds()

Cette méthode retourne les secondes pour une heure spécifiée. La valeur retournée est un entier entre 0 et 59.

Syntaxe

JavaScript1.0 : nomObjetdate.getseconds()

nomObjetdate est soit le nom d’un objet date ou une propriété d’un objet existant.

Exemple

<SCRIPT language="JavaScript">
// Récupère les secondes :
aujourdhui = new Date();
seconde = aujourdhui.getSeconds()
document.write("c'est la "+seconde+" seconde de cette heure<BR>");
</SCRIPT>

getTime()

Cette méthode retourne une valeur numérique correspondant à l’heure pour une date spécifié. La valeur retournée est un nombre en millisecondes. Vous pouvez utiliser cette méthode pour aider l’assignement d’une date et heure à un autre objet date.

Syntaxe

JavaScript1.0 : nomObjetdate.getTime()

nomObjetdate est soit le nom d’un objet date ou une propriété d’un objet existant.

Exemple

<SCRIPT language="JavaScript">
// Récupère le nombre de milliseconde écoulées dans la journée :
aujourdhui = new Date();
milliseconde = aujourdhui.getTime()
document.write("il s'est écoulé "+milliseconde+" millisecondes
	depuis le 1er janvier 1970<BR>");
</SCRIPT>

getTimezoneOffset()

Cette méthode retourne l’heure d’un certain fuseau horaire en minutes.

Syntaxe

JavaScript1.0 : nomObjetdate.getTimezoneOffset()

nomObjetdate est soit le nom d’un objet date ou une propriété d’un objet existant.

Exemple

<SCRIPT language="JavaScript">
// donne la différence (en minutes) entre l'heure courante et l'heure GMT :
aujourdhui = new Date();
GMToffset = aujourdhui.getTimezoneOffset()
document.write("Nous avons "+GMToffset+" minutes de décalage
	avec l'heure GMT<BR>");
</SCRIPT>

getYear()

Cette méthode retourne l’année pour une date spécifiée. La valeur retournée est l’année moins 1900. Par exemple, si l’année est 1987, la valeur retournée est 87.

Syntaxe

JavaScript1.0 : nomObjetdate.getYear()

nomObjetdate est soit le nom d’un objet date ou une propriété d’un objet existant.

Exemple

<SCRIPT language="JavaScript">
/* Cette méthode retourne l'année pour une date spécifiée.
 * La valeur retournée est l'année moins 1900.
 * Par exemple, si l'année est 1987, la valeur retournée est 87.
 */
aujourdhui = new Date();
annee = aujourdhui.getYear()
document.write("il s'est écoulé "+annee+" années depuis 1900<BR>");
</SCRIPT>

parse(messageDate)

Cette méthode retourne le nombre de millisecondes dans une date en chaîne de caractères depuis le 1 janvier 1970 00:00:00, heure locale.

Syntaxe

JavaScript1.0 : Date.parse(dateEnChaîneDeCaractères)

dateEnChaîneDeCaractères est une chaîne de caractères représentant une date ou une propriété d’un objet existant.

Exemple

<SCRIPT language="JavaScript">
/* Retourne le nombre de millisecondes écoulées depuis le 1er janvier 1970
 * A partir d'une chaine de caractère représentant une date
 * ou une propriété d'un objet existant :
 */
mesdixans = Date.parse("25 sep, 79 08:25:55")
document.write(mesdixans+" millisecondes se sont écoulées entre le
	1er janvier 1970 et mon dixieme anniversaire
	(25 sep 1979 08:25:55)<BR>");
</SCRIPT>

setDate(valeurDate)

Cette méthode fixe la journée du mois pour une date spécifiée.

Syntaxe

JavaScript1.0 : nomObjetdate.setDate(ValeurJournée)

nomObjetdate est soit le nom d’un objet date ou une propriété d’un objet existant.
ValeurJournée est un entier entre 1 et 31 ou une propriété d’un objet existant, représentant la journée du mois.

Exemple

<SCRIPT language="JavaScript">
aujourdhui = new Date();
// Affecte le jour du mois à la date (1 à 31):
// dateheure.setDate(valeurDate)
aujourdhui.setDate(25)
document.write(aujourdhui.toLocaleString()+" on est le 25 =>
aujourdhui.setDate(25)<BR>");
</SCRIPT>

setHours(valeurHeure)

Cette méthode fixe l’heure pour une date spécifiée.

Syntaxe

JavaScript1.0 : nomObjetdate.setHours(ValeurHeure)

nomObjetdate est soit le nom d’un objet date ou une propriété d’un objet existant.
ValeurHeure est un entier entre 0 et 23 ou une propriété d’un objet existant, représentant l’heure.

Exemple

<SCRIPT language="JavaScript"> 
aujourdhui = new Date();
// Affecte l'heure à la date (0 à 23):
// aujourdhui.setHours(valeurHeure)
aujourdhui.setHours(8)
document.write(aujourdhui.toLocaleString()+" il est 8 heure => aujourdhui.setHours(8)<BR>");
</SCRIPT>

setMinutes(valeurMinute)

Cette méthode fixe les minutes pour une date spécifiée.

Syntaxe

JavaScript1.0 : nomObjetdate.setMinutes(ValeurMinutes)

nomObjetdate est soit le nom d’un objet date ou une propriété d’un objet existant.
ValeurMinutes est un entier entre 0 et 59 ou une propriété d’un objet existant, représentant les minutes.

Exemple

<SCRIPT language="JavaScript"> 
aujourdhui = new Date();
// Affecte les minutes à la date (0 à 59):
// aujourdhui.setMinutes(valeurMin)
aujourdhui.setMinutes(37)
document.write(aujourdhui.toLocaleString()+" 37 minutes => aujourdhui.setMinutes(37)<BR>");
</SCRIPT>

setMonth(valeurMois)

Cette méthode fixe le mois pour une date spécifiée.

Syntaxe

JavaScript1.0 : nomObjetdate.setMonth(ValeurMois)

nomObjetdate est soit le nom d’un objet date ou une propriété d’un objet existant.
ValeurMois est un entier entre 0 et 11 ou une propriété d’un objet existant, représentant un mois de l’année.

Exemple

<SCRIPT language="JavaScript"> 
aujourdhui = new Date();
// Affecte le mois à la date (0 à 11):
// aujourdhui.setMonth(valeurMois)
aujourdhui.setMonth(8)
document.write(aujourdhui.toLocaleString()+" on est en septembre => aujourdhui.setMonth(8)<BR>");
</SCRIPT>

setSeconds(valeurSeconde)

Cette méthode fixe les secondes pour une date spécifiée.

Syntaxe

JavaScript1.0 : nomObjetdate.setSecondes(ValeurSecondes)

nomObjetdate est soit le nom d’un objet date ou une propriété d’un objet existant.
ValeurSecondes est un entier entre 0 et 59 ou une propriété d’un objet existant.

Exemple

<SCRIPT language="JavaScript"> 
aujourdhui = new Date();
// Affecte les secondes à la date (0 à 59):
// aujourdhui.setSeconds(valeurSec)
aujourdhui.setSeconds(36)
document.write(aujourdhui.toLocaleString()+" 36 secondes => aujourdhui.setSeconds(36)<BR>");
</SCRIPT>

setTime(valeurTemps)

Cette méthode fixe la valeur d’un objet date.

Syntaxe

JavaScript1.0 : nomObjetdate.setTime(valeurTemps)

nomObjetdate est soit le nom d’un objet date ou une propriété d’un objet existant.
valeurTemps est un entier ou une propriété d’un objet existant, représentant le nombre en millisecondes depuis le 1 janvier 1970 00:00:00.

Exemple

<SCRIPT language="JavaScript">
aujourdhui = new Date();
// Affecte une date complète a partir du nombre de secondes écoulées
// depuis le 1 janvier 1970 à 00:00:00
// aujourdhui.setTime(valeurTemps)
mesdixans = Date.parse("25 sep, 79 08:25:55")
aujourdhui.setTime(mesdixans)
document.write("retourne la date à partir du nombre de millisecondes écoulées
	depuis le 01/01/1970 :<BR> aujourdhui.settime(mesdixans) =
	"+aujourdhui.toLocaleString()+"<BR>");
</SCRIPT>

setYear(valeurAnnee)

Cette méthode fixe l’année pour une date spécifiée.

Syntaxe

JavaScript1.0 : nomObjetdate.setYear(valeurAnnée)

nomObjetdate est soit le nom d’un objet date ou une propriété d’un objet existant.
valeurAnnée est un entier plus grand que 1900 ou une propriété d’un objet existant.

Exemple

<SCRIPT language="JavaScript">
aujourdhui = new Date();
// Affecte l'année à la date (nombre d'années depuis 1900) :
// aujourdhui.setYear(valeurAnnee)
aujourdhui.setYear(1987)
document.write(aujourdhui.toLocaleString()+" c'est l'année 1987 =>
	aujourdhui.setYear(87)<BR>");
</SCRIPT>

toGMTString()

Cette méthode fait la conversion d’une date à une chaîne de caractères. Elle utilise la convention GMT d’Internet. Le format de la valeur retournée dépend de la plateforme utilisée.

Syntaxe

JavaScript1.0 : nomObjetdate.toGMTString()

nomObjetdate est soit le nom d’un objet date ou une propriété d’un objet existant.

Exemple

<SCRIPT language="JavaScript">
// convertit un objet date en chaine de caractères utilisant la convention GMT
// Date.toGMTString()
aujourdhui = new Date();
chaineGMT = aujourdhui.toGMTString()
document.writeln("aujourd'hui en GMT :"+chaineGMT);
</SCRIPT>

toLocaleString()

Cette méthode fait la conversion d’une date à une chaîne de caractères. Elle utilise la convention locale.

Syntaxe

JavaScript1.0 : nomObjetdate.toLocaleString()

nomObjetdate est soit le nom d’un objet date ou une propriété d’un objet existant.

Exemple

<SCRIPT language="JavaScript">
// convertit un objet date en chaine de caractères utilisant la notation locale
// Date.toGMTString()
aujourdhui = new Date();
datelocale = aujourdhui.toLocaleString()
document.writeln("aujourd'hui en notation locale : "+datelocale);
</SCRIPT>

UTC(annee,mois,jour[,heure][,minute][,seconde])

Cette méthode retourne le nombre de millisecondes dans un objet date depuis le 1 janvier 1970 00:00:00, heure GMT.

Syntaxe

JavaScript1.0 : Date.UTC(annee, mois, jour [, heure] [, minute] [, seconde])

annee représente l’année après 1900.
mois représente un mois entre 0 et 11.
jour représente une journée entre 1 et 31.
heure représente une heure entre 0 et 23.
minute représente les minutes entre 0 et 59.
seconde représente les secondes entre 0 et 59.

Exemple

<SCRIPT language="JavaScript">
// retourne le nombre de ms écoulés depuis le 1e jan 1970, heure GMT
// Date.UTC(annee,mois,jour[,heure][,min][,sec])
document.write("Date.UTC(25,9,69) = "+Date.UTC(25,9,69)+"<BR>");
Date.UTC(25,9,69)
</SCRIPT>

Christophe Merlet
redfox@redfoxcenter.org
©Tous droits réservés
21 novembre 1998