SELFHTML/Quickbar  JavaScript  Référence objet


Date

Cette page est un document avec du texte et des informations

  Date: généralités sur l'utilisation

Méthodes:

  getDate() (rechercher le jour du mois)
  getDay() (rechercher le jour de la semaine)
  getHours() rechercher la partie heures de l'heure)
  getMinutes() (rechercher la partie minutes de l'heure)
  getMonth() (rechercher le mois)
  getSeconds() (rechercher la partie secondes de l'heure)
  getTime() (rechercher l'heure)
  getTimezoneOffset() (rechercher le décalage horaire avec l'heure locale)
  getYear() (rechercher l'année)
  parse() (rechercher le nombre de millièmes de secondes depuis le 1/1/1970)
  setDate() (fixer le jour du mois)
  setHours() (fixer la partie heures de l'heure)
  setMinutes() (fixer la partie minutes de l'heure)
  setSeconds() (fixer la partie secondes de l'heure)
  setTime() (fixer la date et l'heure)
  setYear() (fixer l'année)
  toGMTString() (convertir le moment au format GMT)
  toLocaleString() (convertir le moment au format local)
  UTC() (rechercher le nombre de millièmes de secondes entre le 1/1/1970 et un moment donné)

 

Date: généralités sur l'utilisation

L'objet Date est qualifié pour tous les calculs d'heure et de date. Pour cela existe, comme il est courant en informatique, un moment fixe historique qui sert de base de calcul et de sauvegarde internes. En JavaScript il s'agit, comme pour le monde C et pour le monde Unix, du 1/1/1970, 0.00 heure. L'unité pour le calcul interne du temps en JavaScript est le millième de seconde.

Avant de pouvoir accéder par JavaScript aux fonctions de date et heure intégrées, il vous faut créer un nouvel objet Date. Pour ceci existent plusieurs variantes.

Variante 1:

nomobjet = new Date();

Variante 2:

nomobjet = new Date("mois jour, annee heures:minutes:secondes");

Variante 3:

nomobjet = new Date(annee,mois,jour);

Variante 4:

nomobjet = new Date(annee,mois,jour,heures,minutes,secondes);

Explication:

Sauvegardez un nouvel objet Date en lui attribuant un nom d'objet vous même. Derrière le nom suit un signe égal, suivi lui même du nom réservé new et de l'appel de la fonction objet Date().

Utilisez la variante 1 si vous voulez créer une instance objet dans laquelle doivent être sauvegardée la date actuelle et l'heure actuelle au moment de l'exécution du programme. Utilisez une des variantes 2 à 4 si vous voulez initialiser le nouvel objet Date avec certaines valeurs (à savoir une date donnée et une heure donnée). Toutes les valeurs d'initialisation comme mois ou minutes doivent être mentionnées sous formes de chiffres, donc par exemple 9 pour le mois d'octobre: quand vous transmettez un mois en valeur numérique comme dans les variantes 3 et 4, il vous faut commencer à compter par 0. Pour Janvier vous transmettez donc 0, pour février 1 et pour décembre 11.
La variante 2 constitue une exception: là, vous transmettez les données d'initialisation comme chaîne de caractères. Ainsi le mois est mentionné dans son orthographe anglaise donc par exemple october. Quand vous transmettez un mois en valeur numérique comme dans les variantes 3 et 4, il vous faut commencer à compter par 0. Pour Janvier vous transmettez donc 0, pour février 1 et pour décembre 11.

Exemple:

function jusq2000()
{
 maintenant = new Date();
 var temps = maintenant.getTime() / 1000;
an2000 = new Date(2000,0,1,0,0,0);
 var tempsfin = an2000.getTime() / 1000;
 var Reste = Math.floor(tempsfin - temps);
 alert("Il y a encore " + Reste + " secondes jusqu'à l'an 2000");
}

Explication:

L'exemple montre une  fonction JavaScript complète. Celle-ci recherche le nombre de secondes entre le moment actuel et l'année 2000. Pour cela, on crée avec maintenant une nouvelle instance objet de l'objet Date avec l'heure actuelle. Pour le moment auquel l'année 2000 commence, on crée une deuxième instance objet de Date, à savoir dans an2000. Pour ceci, les paramètres correspondants sont transmis à la fonction objet Date(). Par les deux noms d'objet maintenant ou respectivement an2000, la méthode nomobjet.getTime() est ensuite appelée. getTime() retourne le nombre de millièmes de secondes depuis le 1/1/1970. Dans la variable temps, on sauvegarde par ce moyen le nombre de secondes écoulées entre le 1/1/1970 et le moment actuel - et dans la variable tempsfin, le nombre de secondes entre le 1/1/1970 et le 1/1/2000. La différence entre les deux valeurs est sauvegardée dans la variable Reste qui est sortie dans une boite de dialogue à l'écran avec alert().

Attention:

Toutes les méthodes avec lesquelles vous pouvez rechercher la date et l'heure actuelles ou des parties d'entre elles, comme le jour de la semaine ou le mois, se réfèrent à l'heure et à la date du système de l'ordinateur de l'utilisateur. Car JavaScript est exécuté chez l'utilisateur par son navigateur. Vous ne pouvez pas rechercher avec JavaScript l'heure système actuelle de l'ordinateur serveur - ceci marchera par exemple avec un script  CGI.

 

JavaScript 1.0Netscape2.0MS IE 3.0 getDate()

Retourne le jour du mois de l'objet nomobjet comme nombre, par exemple 2 si dans le nomobjet le 2/10/1991, 23:59:00, est sauvegardé.

Exemple:

<html><head><title>Test</title>
</head><body>
<script language="JavaScript">
maintenant = new Date();
jour = maintenant.getDate();
document.write("<table border bgcolor=#CCFFFF><tr><td><font size=7>");
document.write(jour + "</font></td></tr></table>");
</script>
</body></html>

Explication:

L'exemple crée un nouvel objet Date avec la date et l'heure actuelles dans le nom d'objet maintenant. Avec maintenant.getDate(), le jour de la date actuelle est recherché dans le mois. La valeur retournée par l'appel est sauvegardée dans la variable jour. Enfin un petit tableau dans lequel le jour de la date actuelle formaté est écrit de façon dynamique dans le fichier à l'aide de document.write().

 

JavaScript 1.0Netscape2.0MS IE 3.0 getDay()

Retourne le jour de la semaine de l'objet nomobjet comme nombre, à savoir sous forme de nombres entre 0 (pour dimanche), 1 (pour lundi) etc. jusqu'à. 6 (pour samedi), donc par exemple 3, si le 2.10.1991, 23:59:00 est sauvegardé dans nomobjet, étant donné que le 2/10/1991 était un mercredi. 

Exemple:

<html><head><title>Test</title>
</head><body>
<script language="JavaScript">
maintenant = new Date();
joursemaine = maintenant.getDay();
var jour = new
Array("dimanche","lundi","mardi","mercredi","jeudi","vendredi","samedi");
document.write("<table border bgcolor=#CCFFFF><tr><td><b>");
document.write(jour[joursemaine] + "</b></td></tr></table>");
</script>
</body></html>

Explication:

L'exemple crée un nouvel objet Date avec l'heure et la date actuelle dans le nom d'objet maintenant. Avec maintenant.getDay(), la valeur numérique du jour de semaine actuel est recherché. La valeur retournée par l'appel est sauvegardée dans la variable joursemaine. Cependant, on veut que ce soit un véritable jour de semaine qui soit sorti. C'est pourquoi, dans l'exemple, un objet  Array a été créé avec les jours de la semaine en français. Le premier élément en est le dimanche, étant donné que la valeur retournée par getDay() est calculé de la même façon interne - avec le dimanche comme premier jour.
Enfin un petit tableau dans lequel le jour de la date actuelle formaté est écrit de façon dynamique dans le fichier à l'aide de document.write(). Veillez cependant à ce que la variable joursemaine soit utilisée comme index pour la sortie du jour correct de l'array jour.

 

JavaScript 1.0Netscape2.0MS IE 3.0 getHours()

Retourne la partie heures de l'heure de l'objet nomobjet comme nombre, par exemple 23, si dans nomobjet est sauvegardé le 2.10.1991, 23:59:00.

Exemple:

<html><head><title>Test</title>
<script language="JavaScript">
 maintenant = new Date();
 heure = maintenant.getHours();
 if(heure >= 5 && heure < 12) alert("Bonjour!");
 else if(heure >= 12 && heure < 18) alert("Bonjour!");
 else if(heure >= 18 && heure <= 23) alert("Bonsoir!");
 else if(heure >= 0 && heure < 5) alert("Il est l'heure d'aller dormir!");
</script>
</head><body>
</body></html>

Explication:

L'exemple crée un nouvel objet Date avec la date et l'heure actuelles dans le nom d'objet maintenant. Avec maintenant.getHours(), l'heure du jour sera recherchée et sauvegardée dans la variable heure. Enfin, une boite de dialogue est sortie avec un texte en fonction de l'heure du jour - dépendant du secteur où est située la valeur de heure.

 

JavaScript 1.0Netscape2.0MS IE 3.0 getMinutes()

Retourne la partie minutes de l'heure de l'objet nomobjet comme nombre par exemple 59, si dans nomobjet est sauvegardé le 2.10.1991, 23:59:00.

Exemple:

<html><head><title>Test</title>
<script language="JavaScript">
 maintenant = new Date();
 heure = maintenant.getHours();
 Min = maintenant.getMinutes();
 var heures  = ((heure < 10) ? "0" + heure : heure);
 var minutes  = ((Min < 10) ? "0" + Min : Min);
 alert("Chez vous il est maintenant " + heures + "." + minutes + " heures");
</script>
</head><body>
</body></html>

Explication:

L exemple crée un nouvel objet Date avec la date et l'heure actuelles dans un nom d'objet maintenant. Avec maintenant.getHours(), l'heure du jour est recherchée, avec maintenant.getMinutes() le nombre de minutes. La valeur retournée par les appels est sauvegardée dans les variables heure et Min. Ensuite le nombre d'heures et de minutes est formaté pour la sortie. Si le nombre d'heures ou de minutes est plus petit que 10, un 0 est placé devant. À la fin, une boite de dialogue indiquant l'heure actuelle est sortie.

 

JavaScript 1.0Netscape2.0MS IE 3.0 getMonth()

Retourne le mois de l'objet nomobjet comme nombre par exemple 9, si dans nomobjet est sauvegardé le 2.10.1991, 23:59:00. Pensez que le comptage des mois commence à 0. 0 est donc janvier, 1 est février etc...

Exemple:

<html><head><title>Test</title>
</head><body>
<script language="JavaScript">
maintenant = new Date();
moisactuel = maintenant.getMonth();
var mois = new
Array("janvier","février","mars","avril","mai","juin",
"juillet","août","septembre","octobre","novembre","décembre");
document.write("<table border bgcolor=#CCFFFF><tr><td><b>");
document.write(mois[moisactuel] + "</b></td></tr></table>");
</script>
</body></html>

Explication:

L' exemple crée un nouvel objet Date avec la date et l'heure actuelles dans le nom d'objet maintenant. Avec maintenant.getMonth(), la valeur numérique du mois actuel est recherchée. La valeur retournées par l'appel est sauvegardée dans la variable moisactuel. Cependant, on veut que ce soit un véritable nom de mois qui soit sorti. C'est pourquoi, dans l'exemple, un objet  Array a été créé avec les noms de mois en français.
Enfin, un petit tableau dans lequel le mois actuel est sorti formaté, est écrit de façon dynamique dans le fichier à l'aide de document.write(). Veillez cependant à ce que la variable moisactuel soit utilisée comme index pour la sortie du mois correct de l'array mois. Étant donné que dans les arrays on compte également à partir de 0, il sera donc par exemple sorti "janvier", quand dans moisactuel la valeur sauvegardée est 0, ou "février", si dans moisactuel le 1 est sauvegardé.

 

JavaScript 1.0Netscape2.0MS IE 3.0 getSeconds()

Retourne les secondes de l'objet nomobjet comme nombre, par exemple 0, si dans nomobjet est sauvegardé le 2.10.1991, 23:59:00, 

Exemple:

<html><head><title>Test</title>
<script language="JavaScript">
var compteur = 0;
function affiche()
{
 maintenant = new Date();
 secondes = maintenant.getSeconds();
 alert(secondes);
 compteur = compteur + 1;
 if(compteur < 3) affiche();
}
affiche();
</script>
</head><body>
</body></html>

Explication:

L' exemple définit une fonction affiche(). Dans cette fonction est créé un nouvel objet Date avec la date et l'heure actuelles dans le nom d'objet maintenant. Avec maintenant.getSeconds(), le nombre de secondes dans la minute actuelle est recherché. La valeur retournée par l'appel est sauvegardé dans la variable secondes. Ensuite, le nombre de secondes est sorti dans une boite de dialoge. Après confirmation de celle-ci par l'utilisateur, la variable compteur est incrémentée de 1. Tant que cette variable est inférieure à 3, la fonction affiche() est appelée à nouveau. Toutes les instructions dans la fonction sont répétées.

 

JavaScript 1.0Netscape2.0MS IE 3.0 getTime()

Retourne le nombre de millièmes de secondes écoulées entre le 1/1/1970 0:00:00, et la date et l'heure actuelles sauvegardées dans nomobjet.

Exemple:

<html><head><title>Test</title>
<script language="JavaScript">
 maintenant = new Date();
 alert(maintenant.getTime());
</script>
</head><body>
</body></html>

Explication:

L' exemple crée un nouvel objet Date avec la date et l'heure actuelles dans le nom d'objet maintenant. Avec alert(maintenant.getTime()), le nombre actuel de millièmes de secondes écoulé depuis le 1/1/1970 est écrit dans une boite de dialogue. Vous pouvez l'essayer tranquillement pour avoir un ordre de grandeur des valeurs retournées par getTime().

 

JavaScript 1.0Netscape2.0MS IE 3.0 getTimezoneOffset()

Retourne la différence entre l'heure locale de l'ordinateur et l'heure GMT en nombre de minutes. Selon la zone de temps locale définie dans l'heure système de l'ordinateur de l'utilisateur, la valeur retournée sera positive ou négative.

Exemple:

<html><head><title>Test</title>
<script language="JavaScript">
 maintenant = new Date();
 ecart = maintenant.getTimezoneOffset() / 60;
 alert("La différence avec Greenwich est de: " + ecart + " heure(s)");
</script>
</head><body>
</body></html>

Explication:

L' exemple voudrait sortir l'écart entre l'heure GMT et l'heure locale en heures. Pour cela, il crée un nouvel objet Date avec l'heure et la date actuelles dans le nom d'objet maintenant. Ensuite, la méthode getTimezoneOffset() est appelée pour cet objet Date. Pour obtenir des heures et non pas un nombre de minutes, la valeur retournée est aussitôt divisée par 60. Le résultat est sauvegardé dans la variable ecart pour être enfin retournée dans une boite de dialogue.

 

JavaScript 1.0Netscape2.0MS IE 3.0 getYear()

Retourne l'année de l'objet nomobjet comme nombre, par exemple 91, si dans nomobjet est sauvegardé le 2.10.1991, 23:59:00 

Exemple:

<html><head><title>Test</title>
</head><body>
<script language="JavaScript">
maintenant = new Date();
an = maintenant.getYear();
if(an < 100) an+=1900;
document.write("<table border bgcolor=#CCFFFF><tr><td><font size=7>");
document.write(an + "</font></td></tr></table>");
</script>
</body></html>

Explication:

L' exemple crée un nouvel objet Date avec la date et l'heure actuelles dans le nom d'objet maintenant. Avec maintenant.getYear() est recherchée l'année actuelle. La valeur retournée par l'appel est sauvegardée dans la variable an. Certains navigateurs sortent encore l'année avec deux chiffres. Pour ce cas, le millésime sera augmenté de 1900. Enfin un petit tableau dans lequel l'année actuelle est sortie formatée est écrit de façon dynamique dans le fichier à l'aide de document.write().

Attention:

Note du traducteur: À partir de l'an 2000, l'Explorer Internet MS 4.x transpose en interne la date automatiquement en nombre de quatre chiffres (dés que la valeur fournie par getYear() est supérieure ou égale à 100), alors que Netscape 4.x continue à la représenter avec les derniers chiffres. Comme après 99 vient 100, 2000 sera donc représenté par 100. L'exemple ci-dessus donnera en l'an 2001 101 comme résultat avec Netscape et 2001 avec l'Explorer Internet MS. Ce dernier livre automatiquement la réponse 2001, même si la demande if(an < 100) an+=1900 est omise. En revanche, si la demande est inversée en if(an >= 100) an+=1900, on obtiendra certes 2001 avec Netscape, mais 3901 (2001 + 1900) avec l'Explorer Internet MS. Pour remédier à ce problème, il faut effectuer une demande tout à fait différente: if(an < 999) an+=1900. Étant donné que getYear() livre une valeur supérieure ou égale à 100 pour les années à partir de 2000, mais inférieure à 999 (jusqu'en 2999), la condition an < 999 est donc remplie, et à la valeur rendue par getYear() est alors ajouté 1900.
Certes, il est possible aussi d'employer la méthode getFullYear(), mais celle-ci a l'inconvénient de provoquer un message d'erreur chez les utilisateurs employant des versions antérieures aux versions 4 de ces navigateurs, cette méthode n'étant pas connue par ceux-ci.

 

JavaScript 1.0Netscape2.0MS IE 3.0 parse()

Recherche dans une chaîne de caractères moment (à transmettre comme paramètre), le nombre de millièmes de secondes écoulées entre le 1/1/1970 0:00:00 et le moment transmis. Notez que, pour l'appel de cette méthode, vous ne devez pas créer de nouvel objet Date, mais pouvez travailler directement avec Date.

Exemple:

<html><head><title>Test</title>
<script language="JavaScript">
 trenteans = Date.parse("Tue, 1 Jan 2000 00:00:00 GMT");
 alert(trenteans);
</script>
</head><body>
</body></html>

Explication:

L' exemple recherche le nombre de millièmes de secondes entre le 1/1/1970 et le 1/1/2000. Le résultat est sauvegardé dans la variable trenteans. Pour le contrôle, ce nombre est sorti dans une boite de dialogue.

 

JavaScript 1.0Netscape2.0MS IE 3.0 setDate()

Modifie le jour du mois sauvegardé dans nomobjet. Le nouveau jour du mois doit être transmis comme paramètre. Les valeurs adéquates se situent entre 1 et 31.

Exemple:

<html><head><title>Test</title>
<script language="JavaScript">
temps = new Date("March 10, 1998 22:48:00");
jour = temps.getDate();
alert(jour);
temps.setDate(1);
jour = temps.getDate();
alert(jour);
</script>
</head><body>
</body></html>

Explication:

L' exemple crée un nouvel objet Date temps avec un moment donné, mentionné dans le format GMT. Pour le contrôle, l'exemple recherche le jour actuel dans le mois du moment donné et le sort dans une fenêtre de dialogue. Ensuite, la méthode setDate() est appliquée sur le nom d'objet temps. Dans l' exemple, le jour du mois est fixé au 1. Finalement et pour le contrôle, le nouveau jour du mois est recherché et sorti avec alert().

 

JavaScript 1.0Netscape2.0MS IE 3.0 setHours()

Modifie la partie heures de l'heure sauvegardée dans nomobjet. La nouvelle partie heures de l'heure doit être transmise comme paramètre. Les valeurs adéquates se situent entre 0 et 23.

Exemple:

<html><head><title>Test</title>
<script language="JavaScript">
temps = new Date();
heures = temps.getHours();
alert(heures);
temps.setHours(23);
heures = temps.getHours();
alert(heures);
</script>
</head><body>
</body></html>

Explication:

L' exemple crée un nouvel objet Date temps avec la date et l'heure actuelles. Pour le contrôle l'exemple recherche la partie heures de l'heure actuelle et la sort dans une boite de dialogue. Ensuite est appelée la méthode setHours() pour être appliquée sur le nom d'objet temps. Dans l' exemple la partie heures de l'heure est fixée à 23. Finalement pour le contrôle, la nouvelle partie heures de l'heure est recherchée pour être enfin sortie avec alert().

 

JavaScript 1.0Netscape2.0MS IE 3.0 setMinutes()

Modifie la partie minutes de l'heure sauvegardée dans nomobjet. La nouvelle partie minutes de l'heure doit être transmise comme paramètre. Les valeurs adéquates se situent entre 0 et 59.

Exemple:

<html><head><title>Test</title>
<script language="JavaScript">
function envers()
{
 temps = new Date();
 Min = temps.getMinutes();
 nouvmin = temps.setMinutes(60-Min);
 Min = temps.getMinutes();
 return(Min);
}
</script>
</head><body>
<a href="javascript:alert(envers())">Test</a>
</body></html>

Explication:

L'exemple contient un lien qui lorsqu'on le clique sort la valeur retournée par la fonction envers() notée dans un passage JavaScript de l'entête de fichier. Dans cette fonction, un nouvel objet Date temps avec l'heure et la date actuelles est créé. La partie minutes de l'heure actuelle est recherchée et ensuite, avec la méthode setHours(), inversée. Si par exemple il était auparavant 18:12 heures, il sera à la suite 18:48 heures. La nouvelle partie minutes de l'heure est une nouvelle fois recherchée puis sortie. Une telle fonction pourrait par exemple avoir son sens pour créer une horloge fonctionnant à l'envers.

 

JavaScript 1.0Netscape2.0MS IE 3.0 setSeconds()

Modifie la partie secondes de l'heure sauvegardée dans nomobjet. La nouvelle partie secondes de l'heure doit être transmise comme paramètre. Les valeurs adéquates se situent entre 0 et 59.

Exemple:

<html><head><title>Test</title>
<script language="JavaScript">
function heures()
{
 temps = new Date();
 heure = temps.getHours();
 Min = temps.getMinutes();
 Sec = temps.getSeconds();
 nouvsec = temps.setSeconds(Math.floor(Sec / 10));
 Sek = temps.getSeconds();
 return(heure+ "." + Min + ":" + Sek + "0");
}
</script>
</head><body>
<a href="javascript:alert(heures())">heure</a>
</body></html>

Explication:

L' exemple contient un lien qui, lorsqu'on le clique, sort la valeur retournée par la fonction heures() notée dans un passage JavaScript de l'entête de fichier. Il s'agit bien de l'heure actuelle, sortie cependant de telle façon que les secondes ne sont indiquées que par multiples de 10. Une sortie telle que 18.10:37 n'est donc pas possible, la fonction en ferait 18.10:30. À cette fin est créé un nouvel objet Date temps avec la date et l'heure actuelles. Les parties constituantes de la date sont recherchées dans cette variable. Avec la méthode setSeconds(), la partie secondes de l'heure est traitée. Par une petite opération mathématique, le nombre de secondes possibles entre 0 et 59 devient un nombre entre 0 et 5. Ensuite, la nouvelle partie secondes de l'heure est recherchée encore une fois. Lorsque l'heure est retournée, un 0 est ajouté au nombre des secondes à un chiffre, car "en réalité" le nombre à un chiffre représente les dizaines de secondes.

 

JavaScript 1.0Netscape2.0MS IE 3.0 setTime()

Modifie le contenu complet de nomobjet en une seule fois, permettant ainsi de fixer une nouvelle date et heure de son choix dans nomobjet. Attend comme paramètre un nombre qui marque les nouvelles date et heure. Le nombre est interprété comme nombre de millièmes de secondes depuis le 1/1/1970 0:00:00.

Exemple:

<html><head><title>Test</title>
<script language="JavaScript">
 temps = new Date();
 AbsoluMaintenant = temps.getTime();
 Absoluensuite = AbsoluMaintenant + (100*24*60*60*1000);
 temps.setTime(Absoluensuite);
 an = temps.getYear();
 mois = temps.getMonth() + 1;
 jour = temps.getDate();
 alert("Dans 100 jours nous serons le " + jour + "/" + mois + "/" + an);
</script>
</head><body>
</body></html>

Explication:

L' exemple sort la date qui sera actuelle dans 100 jours à compter d'aujourd'hui. À cet effet un nouvel objet Date temps a été créé avec la date et l'heure actuelles. Avec getTime() est recherché, dans un premier temps, le nombre absolu de millièmes de secondes entre le 1/1/1970 et la date et l'heure actuelles pour le sauvegarder dans la variable AbsoluMaintenant. Enfin est ajouté à ce nombre le produit de 100*24*60*60*1000. Il s'agit du nombre de millièmes de secondes pour 100 jours. Le résultat est sauvegardé dans la variable Absoluensuite. Cette valeur est transmise à la méthode setTime(). Ainsi le temps sera fixé à un moment dans 100 jours. À l'aide de commandes correspondantes sont recherchées dans ce nouveau temps fixé les valeurs pour le jour du mois, le mois et l'année. Le résultat est ensuite sorti dans une boite de dialogue.

 

JavaScript 1.0Netscape2.0MS IE 3.0 setYear()

Modifie l'année sauvegardée dans nomobjet. Le millésime est à transmettre comme paramètre.

Exemple:

<html><head><title>Test</title>
<script language="JavaScript">
 temps = new Date();
 AbsoluMaintenant = temps.getTime();
 an = temps.getYear();
 temps.setYear(an+1);
 Absoluensuite = temps.getTime();
 ecart = Absoluensuite - AbsoluMaintenant;
 alert("jusqu'à la même heure l'année prochaine il y a  " + ecart + "ms");
</script>
</head><body>
</body></html>

Explication:

L' exemple donne le nombre de millièmes de secondes qui s'écouleront de l'heure et de la date actuelles jusqu'à la même heure dans un an. À cette fin est créé un nouvel objet Date temps avec l'heure et la date actuelles. Le moment absolu en millièmes de secondes est recherché avec getTime() et sauvegardé dans la variable AbsoluMaintenant. Avec getYear(), le millésime actuel est recherché. Puis la date actuelle est repoussée un an plus tard dans le futur avec setYear(). Le moment absolu en millièmes de seconde est recherché à nouveau avec getTime(). Le résultat est sauvegardé dans la variable Absoluensuite. Par la différence entre les valeurs sauvegardées de Absoluensuite et AbsoluMaintenant, le nombre de millièmes de secondes jusqu'au même moment dans un an est recherché. Le résultat est sorti dans une boite de dialogue.
Note du traducteur: Pour les années supérieures ou égales à 2000, se référer à la  note du traducteur.

 

JavaScript 1.0Netscape2.0MS IE 3.0 toGMTString()

Transforme les données sauvegardées dans nomobjet dans une chaîne de caractères d'après le standard IETF. Si par exemple le 2/10/1991 est sauvegardé dans nomobjet, cette méthode retournera : "Wed, 2 Oct 1991 23:59:00 GMT" (plus ou moins le nombre d'heures correspondant à l'endroit et/ou si c'est l'heure d'été ou d'hiver).

Exemple:

<html><head><title>Test</title>
<script language="JavaScript">
 Maintenant = new Date();
 alert(Maintenant.toGMTString());
</script>
</head><body>
</body></html>

Explication:

L' exemple crée un nouvel objet Date Maintenant avec la date et l'heure actuelles. Ensuite il donne le résultat de la méthode Maintenant.toGMTString() dans une boite de dialogue. Exemple d'une sortie:
Wed, 11 Mar 1998 18:17:28 GMT (Netscape)
Wed, 11 Mar 1998 18:17:28 UTC (MS Internet Explorer)

 

JavaScript 1.0Netscape2.0MS IE 3.0 toLocaleString()

Transforme les données sauvegardées dans nomobjet en une chaîne de caractères. La chaîne de caractères retournée prend en considération l'heure locale. Si par exemple le 2/10/1991 23:59:00 est sauvegardé dans nomobjet, cette méthode peut retourner: "10/2/91 23:59".

Exemple:

<html><head><title>Test</title>
<script language="JavaScript">
 Maintenant = new Date();
 alert(Maintenant.toLocaleString());
</script>
</head><body>
</body></html>

Explication:

L' exemple crée un nouvel objet Date Maintenant avec l'heure et la date actuelles. Puis il donne le résultat de la méthode Maintenant.toLocaleString() dans une boite de dialogue. Exemple de sortie:
03/11/1998 19:21:22

 

JavaScript 1.0Netscape2.0MS IE 3.0 UTC()

Retourne le nombre de millièmes de secondes écoulés entre le 1/1/1970 et une date et heure au choix. La date et heure sont à transmettre sous forme de paramètres. Tous les paramètres sont à transmettre comme valeurs numériques. La mention des valeurs pour la date est obligatoire, celle de l'heure est facultative. Les paramètres en détail:
1. an = millésime.
2. mois = nombre du mois entre 0 et 11.
3. jour = nombre du jour entre 1 et 31.
4. heure = (facultatif) partie heures de l'heure entre 0 et 23.
5. minutes = (facultatif)partie minutes de l'heure entre 0 et 59.
6. secondes = (facultatif) partie secondes de l'heure entre 0 et 59.

Exemple:

<html><head><title>Test</title>
</head><body>
<script language="JavaScript">
 document.write(Date.UTC(1998,2,11,19,26,00));
</script>
</body></html>

Explication:

L' exemple écrit dans le fichier avec document.write() le nombre de millièmes de secondes écoulées entre le 1/1/1970, 0.00 heures, et le 11/3/1998, 19.26 heures.

après: Function
avant: Boolean
 

SELFHTML/Quickbar  JavaScript  Référence objet

© 1998 Stefan Münz / © 2001 Traduction  Serge François, 13405@free.fr