SELFHTML/Aides à la navigation JavaScript/DOM Référence objet| SELFHTML/Aides à la navigation JavaScript/DOM Référence objet |
 |
Date |
|
Méthodes:
|
 | |
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.
nom_objet = new Date(); |
nom_objet = new Date("mois jour, annee heures:minutes:secondes"); |
nom_objet = new Date(annee,mois,jour); |
nom_objet = new Date(annee,mois,jour,heures,minutes,secondes); |
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ées 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 . 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. C'est la raison pour laquelle, pour le mois d'octobre, 9 a été transmis et non pas 10.
<html><head><title>Test</title>
<script type="text/javascript">
<!--
function jusque_2020() {
var maintenant = new Date();
var temps = maintenant.getTime() / 1000;
var an_2020 = new Date(2020,0,1,0,0,0);
var temps_final = an_2020.getTime() / 1000;
var reste = Math.floor(temps_final - temps);
alert("Il y a encore " + reste + " secondes jusqu'à l'an 2020");
}
//-->
</script>
</head><body>
<a href="javascript:jusque_2020()">Combien y a-t-il encore?</a>
</body></html>
|
L'exemple montre une 
fonction JavaScript complète. Celle-ci recherche le nombre de secondes entre le moment actuel et l'année 2020. 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 2020 commence, on crée une deuxième instance objet de Date, à savoir dans an_2020. Pour ceci, les paramètres correspondants sont transmis à la fonction objet Date(). Par les deux noms d'objet maintenant ou bien an_2020, la méthode nom_objet.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 temps_final, le nombre de secondes entre le 1/1/1970 et le 1/1/2020. 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().
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.
 |
getDate()Retourne le jour du mois de l'objet nom_objet comme nombre, par exemple 2 si dans nom_objet le 2/10/1991, 23:59:00, est sauvegardé.
<html><head><title>Test</title>
</head><body>
<script type="text/javascript">
<!--
var maintenant = new Date();
var jour = maintenant.getDate();
document.write('<table border bgcolor="#CCFFFF"><tr><td><font size="7">');
document.write(jour + "<\/font><\/td><\/tr><\/table>");
//-->
</script>
</body></html>
|
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(). Pour éviter de devoir masquer le ", c'est ' qui a été choisi comme délimiteur de texte.
|
|
getDay()Retourne le jour de la semaine de l'objet nom_objet 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 nom_objet, étant donné que le 2/10/1991 était un mercredi.
<html><head><title>Test</title>
</head><body>
<script type="text/javascript">
<!--
var maintenant = new Date();
var jour_dans_semaine = maintenant.getDay();
var jour_semaine = new
Array("dimanche","lundi","mardi","mercredi","jeudi","vendredi","samedi");
document.write('<table border bgcolor="#CCFFFF"><tr><td><b>');
document.write(jour_semaine[jour_dans_semaine] + "<\/b><\/td><\/tr><\/table>");
//-->
</script>
</body></html>
|
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 jour_dans_semaine. 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 jour_dans_semaine soit utilisée comme index pour la sortie du jour correct de l'array jour_semaine.
|
|
getFullYear()Renvoie par opposition à getYear() l'année complète pour les navigateurs Netscape. Pour l'Explorer Internet, les deux méthodes retournent la même valeur.
<html><head><title>Test</title>
</head><body>
<script type="text/javascript">
<!--
var maintenant = new Date();
var annee = maintenant.getFullYear();
document.write("Nous sommes en " + annee);
//-->
</script>
</body></html>
|
L'exemple crée un nouvel objet Date avec les date et heure actuelles dans un nom d'objet maintenant. Avec maintenant.getFullYear() l'année actuelle complète est recherchée. La valeur renvoyée de cet appel est sauvegardé dans la variable annee. Enfin et pour contrôle, un texte avec la sortie de cette variable est écrit dans la fenêtre du document.
|
|
getHours()Retourne la partie heures de l'heure de l'objet nom_objet comme nombre, par exemple 23, si dans nom_objet est sauvegardé le 2.10.1991, 23:59:00.
<html><head><title>Test</title>
<script type="text/javascript">
<!--
var maintenant = new Date();
var 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>
|
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.
|
|
getMilliseconds()Recherche le nombre des millièmes de secondes écoulés depuis la dernière seconde pleine.
<html><head><title>Test</title>
<script type="text/javascript">
<!--
function actualiser() {
var temps = new Date();
var ms = temps.getMilliseconds();
document.formulaire.sortie.value = ms;
}
//-->
</script>
</head><body onLoad="document.formulaire.sortie.value='0'">
<form name="formulaire" action="">
<input name="sortie" type="text">
<input type="button" value="actualiser" onClick="actualiser()">
</form>
</body></html>
|
L'exemple contient un formulaire avec un champ de saisie et un bouton pouvant être cliqué. Lorsqu'on le clique, la fonction actualiser(), notée dans l'entête de fichier, est appelée. Cette fonction crée un nouvel objet date avec l'heure et la date actuelles dans le nom d'objet temps. Avec temps.getMilliseconds() les millièmes de secondes écoulés depuis la dernière seconde pleine sont recherchés. La valeur renvoyée par cet appel est sauvegardée dans la variable ms. Enfin, la valeur du champ de saisie du formulaire est occupée par la valeur trouvée, afin d'afficher le résultat.
|
|
getMinutes()Retourne la partie minutes de l'heure de l'objet nom_objet comme nombre par exemple 59, si par exemple est sauvegardé dans nom_objet le 2.10.1991, 23:59:00.
<html><head><title>Test</title>
<script type="text/javascript">
<!--
var maintenant = new Date();
var heure = maintenant.getHours();
var Min = maintenant.getMinutes();
var sortie_heure = ((heure < 10) ? "0" + heure : heure);
var sortie_minutes = ((Min < 10) ? "0" + Min : Min);
alert("Chez vous, il est maintenant maintenant " + sortie_heure + "." + sortie_minutes + " heures");
//-->
</script>
</head><body>
</body></html>
|
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.
|
|
getMonth()Retourne le mois de l'objet nom_objet comme nombre par exemple 9, si dans nom_objet 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...
<html><head><title>Test</title>
</head><body>
<script type="text/javascript">
<!--
var maintenant = new Date();
var mois_annee = 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[mois_annee] + "<\/b><\/td><\/tr><\/table>");
//-->
</script>
</body></html>
|
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ée par l'appel est sauvegardée dans la variable mois_annee. 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 mois_annee 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 mois_annee la valeur sauvegardée est 0, ou "février", si dans mois_annee le 1 est sauvegardé.
|
|
getSeconds()Retourne les secondes de l'objet nom_objet comme nombre, par exemple 0, si dans nom_objet est sauvegardé le 2.10.1991, 23:59:00.
<html><head><title>Test</title>
<script type="text/javascript">
<!--
var compteur = 0;
function affiche() {
var maintenant = new Date();
var secondes = maintenant.getSeconds();
alert(secondes);
compteur = compteur + 1;
if(compteur < 3) affiche();
}
affiche();
//-->
</script>
</head><body>
</body></html>
|
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 dialogue. 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.
|
|
getTime()Retourne le nombre de millièmes de secondes, en tant que nombre, qui se sont écoulées depuis le 1er janvier 1970, 0:00:00, jusqu'à une date et une heure sauvegardées dans nom_objet.
<html><head><title>Test</title> <script type="text/javascript"> <!-- var maintenant = new Date(); alert(maintenant.getTime()); //--> </script> </head><body> </body></html> |
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().
|
|
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.
<html><head><title>Test</title>
<script type="text/javascript">
<!--
var maintenant = new Date();
var ecart = maintenant.getTimezoneOffset() / 60;
alert("La différence avec Greenwich est de: " + ecart + " heure(s)");
//-->
</script>
</head><body>
</body></html>
|
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.
Il n'est pas tenu compte de l'heure d'été dans cette méthode.
|
|
getUTCDate()Cette méthode a une fonction identique à celle de getDate(), livre cependant une valeur non pas pour l'heure locale, mais pour le Universal Coordinated Time (UTC), appelée aussi heure GMT.
|
|
getUTCDay()Cette méthode a une fonction identique à celle de getDay(), livre cependant une valeur non pas pour l'heure locale, mais pour le Universal Coordinated Time (UTC), appelée aussi heure GMT.
|
|
getUTCFullYear() Cette méthode a une fonction identique à celle de getFullYear(), livre cependant une valeur non pas pour l'heure locale, mais pour le Universal Coordinated Time (UTC), appelée aussi heure GMT..
|
|
getUTCHours()Cette méthode a une fonction identique à celle de getHours(), livre cependant une valeur non pas pour l'heure locale, mais pour le Universal Coordinated Time (UTC), appelée aussi heure GMT.
|
|
getUTCMilliseconds()Cette méthode a une fonction identique à celle de getMilliseconds(), livre cependant une valeur non pas pour l'heure locale, mais pour le Universal Coordinated Time (UTC), appelée aussi heure GMT.
|
|
getUTCMinutes()Cette méthode a une fonction identique à celle de getMinutes(), livre cependant une valeur non pas pour l'heure locale, mais pour le Universal Coordinated Time (UTC), appelée aussi heure GMT.
|
|
getUTCMonth()Cette méthode a une fonction identique à celle de getMonth(), livre cependant une valeur non pas pour l'heure locale, mais pour le Universal Coordinated Time (UTC), appelée aussi heure GMT.
|
|
getUTCSeconds()Cette méthode a une fonction identique à celle de getSeconds(), livre cependant une valeur non pas pour l'heure locale, mais pour le Universal Coordinated Time (UTC), appelée aussi heure GMT.
|
|
getYear()Retourne l'année de l'objet nom_objet comme nombre, par exemple 91, si dans nom_objet est sauvegardé le 2.10.1991, 23:59:00.
<html><head><title>Test</title>
</head><body>
<script type="text/javascript">
<!--
var maintenant = new Date();
var annee = maintenant.getYear();
if(annee < 999) annee+=1900;
document.write("<h1>" + annee + "<\/h1>");
//-->
</script>
</body></html>
|
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 annee. 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(). .
|
|
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.
<html><head><title>Test</title>
<script type="text/javascript">
<!--
var trente_ans = Date.parse("Tue, 1 Jan 2000 00:00:00 GMT");
alert(trente_ans);
//-->
</script>
</head><body>
</body></html>
|
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 trente_ans. Pour le contrôle, ce nombre est sorti dans une boite de dialogue.
|
|
setDate()Modifie le jour du mois sauvegardé dans nom_objet. Le nouveau jour du mois doit être transmis comme paramètre. Les valeurs adéquates se situent entre 1 et 31.
<html><head><title>Test</title>
<script type="text/javascript">
<!--
var temps = new Date("March 10, 1998 22:48:00");
var jour = temps.getDate();
alert(jour);
temps.setDate(1);
jour = temps.getDate();
alert(jour);
//-->
</script>
</head><body>
</body></html>
|
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 1er. Finalement et pour le contrôle, le nouveau jour du mois est recherché et sorti.
|
|
setFullYear()modifie le millésime sauvegardé dans nom_objet. La nouvelle année est à transmettre comme paramètre.
<html><head><title>Test</title>
</head><body>
<script type="text/javascript">
<!--
var temps = new Date();
var futur = temps.setFullYear(2037);
document.write("Nous finirons bien par écrire l'année " + temps.getUTCFullYear());
//-->
</script>
</body></html>
|
L'exemple crée un nouvel objet date temps. Ensuite, la méthode setFullYear() est appliquée sue le nom d'objet temps. Dans l'exemple, l'année a été fixée à 2037. Enfin, le résultat est sorti pour contrôle dans le document.
|
|
setHours()Modifie la partie heures de l'heure sauvegardée dans nom_objet. La nouvelle partie heures de l'heure doit être transmise comme paramètre. Les valeurs adéquates se situent entre 0 et 23.
<html><head><title>Test</title> <script type="text/javascript"> <!-- var temps = new Date(); var heure = temps.getHours(); alert(heure); temps.setHours(23); heure = temps.getHours(); alert(heure); //--> </script> </head><body> </body></html> |
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.
|
|
setMilliseconds()Modifie les millièmes de seconde de l'heure sauvegardée dans nom_objet. le nombre de millièmes de seconde est à transmettre comme paramètre. Les valeurs adéquates se situent entre 0 et999.
<html><head><title>Test</title>
<script type="text/javascript">
<!--
function set0() {
temps = new Date();
temps.setMilliseconds(0);
}
function getNow() {
temps = new Date();
alert(temps.getMilliseconds() + " millièmes de secondes sont écoulés depuis le clic de souris");
}
//-->
</script>
</head><body>
<p>Cliquez sur le premier lien et ensuite très vite sur le second!</p>
<p><a href="javascript:set0()">premier</a>
<a href="javascript:getNow()">deuxième</a></p>
</body></html>
|
L'exemple contient deux liens. L'utilisateur doit d'abord cliquer sur le premier, puis en l'espace d'une seconde sur le deuxième. Les deux liens appellent chacun une fonction, notée dans l'entête de fichier. Le premier lien appelle set0(). Il y est créé un nouvel objet date temps avec l'heure actuelle. Enfin avec temps.setMilliseconds(0) le nombre des millièmes de secondes est mis à 0. La fonction getNow(), appelée par l'autre lien, crée elle aussi un objet date avec l'heure actuelle, mais sort ensuite avec temps.getMilliseconds() les millièmes de seconde écoulés depuis la remise à 0.
|
|
setMinutes()Modifie la partie minutes de l'heure sauvegardée dans nom_objet. La nouvelle partie minutes de l'heure doit être transmise comme paramètre. Les valeurs adéquates se situent entre 0 et 59.
<html><head><title>Test</title>
<script type="text/javascript">
<!--
function envers() {
var temps = new Date();
var Min = temps.getMinutes();
var nouv_min = temps.setMinutes(60-Min);
var Min = temps.getMinutes();
return(Min);
}
//-->
</script>
</head><body>
<a href="javascript:alert(envers())">Test</a>
</body></html>
|
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 setMinutes(), 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.
|
|
setMonth()Modifie le mois qui est sauvegardé dans nom_objet . La valeur désirée du mois est à transmettre comme paramètre. Les valeurs adéquates se situent entre 0 et 11.
<html><head><title>Test</title>
<script type="text/javascript">
<!--
function autremois() {
var temps = new Date();
var jour = temps.getDate();
temps.setMonth(Math.round(Math.random() * 11));
var mois = temps.getMonth();
return(jour + "." + (mois+1) + ".");
}
//-->
</script>
</head><body>
<a href="javascript:alert(autremois())">autre mois</a>
</body></html>
|
L'exemple contient un lien. En cliquant sur ce lien, la valeur retournée par la fonction autre_mois() notée dans le passage script de l'entête de fichier est sortie. Dans celle-ci est créé un nouvel objet Date temps avec la date et l'heure actuelle. Grâce à la méthode setMonth() un nouveau mois est fixé et ce, de façon aléatoire. Pour cela est recherché à l'aide de Math.round() et de Math.random() un nombre entier aléatoire compris entre 0 et 11. Ce nombre est transmis comme paramètre à la méthode setMonth(). Le nouveau nombre du mois est encore une fois recherché pour être ensuite renvoyé formaté de telle façon qu'une date cohérente soit affichée
|
|
setSeconds()Modifie la partie secondes de l'heure sauvegardée dans nom_objet. La nouvelle partie secondes de l'heure doit être transmise comme paramètre. Les valeurs adéquates se situent entre 0 et 59.
<html><head><title>Test</title>
<script type="text/javascript">
<!--
function heures() {
var temps = new Date();
var heure = temps.getHours();
var Min = temps.getMinutes();
var sec = temps.getSeconds();
var nouv_sec = temps.setSeconds(Math.floor(sec / 10));
sec = temps.getSeconds();
return(heure + ":" + Min + ":" + sec + "0");
}
//-->
</script>
</head><body>
<a href="javascript:alert(heures())">heure</a>
</body></html>
|
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.
|
|
setTime()Modifie le contenu complet de nom_objet en une seule fois, permettant ainsi de fixer une nouvelle date et heure de son choix dans nom_objet. 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.
<html><head><title>Test</title>
<script type="text/javascript">
<!--
var temps = new Date();
var absolu_maintenant = temps.getTime();
var absolu_ensuite = absolu_maintenant + (100*24*60*60*1000);
temps.setTime(absolu_ensuite);
var annee = temps.getYear();
var mois = temps.getMonth() + 1;
var jour = temps.getDate();
alert("Dans 100 jours nous serons le " + jour + "/" + mois + "/" + annee);
//-->
</script>
</head><body>
</body></html>
|
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 absolu_maintenant. 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 absolu_ensuite. 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.
|
|
setUTCDate()Cette méthode a une fonction identique à celle de setDate(), la valeur fixée ne signifie pourtant pas l'heure locale , mais le Universal Coordinated Time (UTC), appelée aussi heure GMT.
|
|
setUTCDay()Cette méthode a une fonction identique à celle de setDay(), la valeur fixée ne signifie pourtant pas l'heure locale , mais le Universal Coordinated Time (UTC), appelée aussi heure GMT.
|
|
setUTCFullYear()Cette méthode a une fonction identique à celle de setFullYear(), la valeur fixée ne signifie pourtant pas l'heure locale , mais le Universal Coordinated Time (UTC), appelée aussi heure GMT.
|
|
setUTCHours()Cette méthode a une fonction identique à celle de setHours(), la valeur fixée ne signifie pourtant pas l'heure locale , mais le Universal Coordinated Time (UTC), appelée aussi heure GMT.
|
|
setUTCMilliseconds()Cette méthode a une fonction identique à celle de setMilliseconds(), la valeur fixée ne signifie pourtant pas l'heure locale , mais le Universal Coordinated Time (UTC), appelée aussi heure GMT.
|
|
setUTCMinutes()Cette méthode a une fonction identique à celle de setMinutes(), la valeur fixée ne signifie pourtant pas l'heure locale , mais le Universal Coordinated Time (UTC), appelée aussi heure GMT.
|
|
setUTCMonth()Cette méthode a une fonction identique à celle de setMonth(), la valeur fixée ne signifie pourtant pas l'heure locale , mais le Universal Coordinated Time (UTC), appelée aussi heure GMT.
|
|
setUTCSeconds()Cette méthode a une fonction identique à celle de setSeconds(), la valeur fixée ne signifie pourtant pas l'heure locale , mais le Universal Coordinated Time (UTC), appelée aussi heure GMT.
|
|
setYear()Modifie l'année sauvegardée dans nom_objet. Le millésime est à transmettre comme paramètre.
<html><head><title>Test</title>
<script type="text/javascript">
<!--
var temps = new Date();
var absolu_maintenant = temps.getTime();
var annee = temps.getYear();
temps.setYear(annee+1);
var absolu_ensuite = temps.getTime();
var ecart = absolu_ensuite - absolu_maintenant;
alert("jusqu'à la même heure l'année prochaine il y a " + ecart + "millièmes de seconde");
//-->
</script>
</head><body>
</body></html>
|
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 absolu_maintenant. 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 absolu_ensuite. Par la différence entre les valeurs sauvegardées de absolu_ensuite et absolu_maintenant, 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.
|
|
toGMTString()Transforme les données sauvegardées dans nom_objet dans une chaîne de caractères d'après le standard IETF. Si par exemple le 2/10/1991 est sauvegardé dans nom_objet, 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).
<html><head><title>Test</title> <script type="text/javascript"> <!-- var maintenant = new Date(); alert(maintenant.toGMTString()); //--> </script> </head><body> </body></html> |
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 (Explorer Internet MS)
Il n'est pas tenu compte de l'heure d'été dans cette méthode..
|
|
toLocaleString()Transforme les données sauvegardées dans nom_objet 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".
<html><head><title>Test</title> <script type="text/javascript"> <!-- var maintenant = new Date(); alert(maintenant.toLocaleString()); //--> </script> </head><body> </body></html> |
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
|
|
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. annee = millésime.
2. mois = nombre du mois entre 0 et 11.
3. jour = nombre du jour entre 1 et 31.
4. heures = (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.
<html><head><title>Test</title> </head><body> <script type="text/javascript"> <!-- document.write(Date.UTC(1998,2,11,19,26,00)); //--> </script> </body></html> |
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.
|
| |
 |
Function
|
 |
Boolean
|
| SELFHTML/Aides à la navigation JavaScript/DOM Référence objet |
© 2001 Stefan Münz / © 2003 Traduction 
Serge François, 13405@free.fr selfhtml@fr.selfhtml.org
