JsLib 1.4

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 :

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.
 
Détail des fonctions

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.

JsLib 1.4

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