Script heure.js
Le script heure.js permet de formater l'heure courante et de l'afficher dans votre
page de manière statique ou dynamique.
L'heure courante est obtenue dynamiquement à chaque fois que l'on en a besoin, en créant
un nouvel objet Date. Ensuite, plusieurs fonctions permettent ensuite de formater
l'heure dans différents formats :
- HH:MM
- HH:MM:SS
- HH heure(s) MM
- HH:MM am/pm
De plus, deux fonctions permettent d'activer et de désactiver la mise à jour dynamique
de l'heure dans le champ d'un formulaire.
- Depuis :
- JsLib 1.0
- Voir aussi :
- chrono.js
Résumé des fonctions |
|
chargerHeureDyna(élément champ)
Active la mise à jour dynamique de l'heure pour le champ spécifié. |
|
dechargerHeureDyna()
Désactive la mise à jour dynamique de l'heure précedemment activée. |
chaîne |
heureCour()
Retourne l'heure courante au format HH:MM:SS. |
chaîne |
heureCourAbr()
Retourne l'heure courante en abrégé, au format HH:MM. |
chaîne |
heureCourAMPM()
Retourne l'heure courante au format HH:MM am/pm. |
chaîne |
heureCourLng()
Retourne l'heure courante au format HH heure(s) MM. |
chargerHeureDyna
chargerHeureDyna(élément champ)
-
Active la mise à jour dynamique de l'heure pour le champ spécifié. Une fois la fonction appelée,
le champ de formulaire passé en paramètre sera mis à jour toutes les secondes avec la valeur
de retour de la fonction heureCour(). Cette fonction est généralement appelée lorsque
l'utilisateur charge la page (événement window.onLoad). Elle permet d'insérer une
horloge dans une page Web.
- Paramètres :
- champ - une référence sur le champ de formulaire à mettre à jour dynamiquement.
dechargerHeureDyna
dechargerHeureDyna()
-
Désactive la mise à jour dynamique de l'heure précedemment activée. Lorsqu'un champ
est mis à jour dynamiquement avec l'heure courante suite à l'appel de la fonction
chargerHeureDyna(chaîne champ), le timer associé au champ est arrêté
et le champ n'est plus mis à jour. Cette fonction est généralement appelée lorsque
l'utilisateur quitte la page (événement window.onUnload).
heureCour
chaîne heureCour()
-
Retourne l'heure courante au format HH:MM:SS. Exemple : "17:46:08".
- Retourne :
- une chaîne contenant l'heure courante.
heureCourAbr
chaîne heureCourAbr()
-
Retourne l'heure courante en abrégé, au format HH:MM. Exemple : "17:46".
- Retourne :
- une chaîne contenant l'heure courante.
heureCourAMPM
chaîne heureCourAMPM()
-
Retourne l'heure courante au format HH:MM am/pm.
Il s'agit du format anglo-saxon pour la lecture de l'heure, basé sur
les abréviations latines AM (Ante Meridiem) et PM (Post Meridiem). Exemple : "5:46 pm".
- Retourne :
- une chaîne contenant l'heure courante.
heureCourLng
chaîne heureCourLng()
-
Retourne l'heure courante au format HH heure(s) MM. Exemple : "17 heures 46".
- Retourne :
- une chaîne contenant l'heure courante.
Erreurs, critiques, améliorations, questions :
écrivez à l'auteur.
JsLib version 1.4 - bibliothèque JavaScript distribuée sous licence GNU LGPL
Auteur : Etienne CHEVILLARD
Mise à jour : 12/12/2007