Modèle:Heure/Documentation
From Wikipedia, the free encyclopedia
Le modèle {{Heure}} permet d’écrire facilement et de typographier correctement une durée, ou un instant donné, en heures (voir les usages conventionnels). Par rapport à une écriture directe, ses avantages sont :
- corriger les erreurs de typographie courantes, comme « 22h34 » à la place de « 22 h 34 » ;
- éviter un retour à la ligne automatique entre les nombres et le « h », comme dans « 22 h
34 » en fin de ligne.
Syntaxe
{{Heure|heures}}{{Heure|heures|minutes}}{{Heure|heures|minutes|durée=oui}}{{Heure|heures|minutes|secondes}}{{Heure|heures|minutes|secondes|centièmes de secondes}}{{Heure||minutes|secondes}}{{Heure|heures|minutes|fuseau=fuseau horaire}}{{Heure|heures|minutes|alignement=oui}}
Exemples d’utilisation
| Syntaxe | Résultat | Commentaire |
|---|---|---|
{{Heure|22}} |
22 h 8 h |
Cas d’utilisation minimale qui ne doit pas être utilisé dans un texte où la typographie doit être sous la forme « 22 heures » ou « 8 heures » (voir Usages conventionnels). |
{{Heure|22|34}} |
22 h 34 13 h 9 13 h 9 |
Cas d’utilisation classique[1]. |
{{Heure|22|34|durée=oui}} |
22 h 34 min | Si l’heure et la minute sont précisées mais pas les secondes, permet de préciser que l’on a affaire à une durée et non à un instant, pour forcer l’affichage de l’unité « min ». |
{{Heure|22|34|45}} |
22 h 34 min 45 s 11 h 4 min 9 s |
Cas où le nombre de secondes est spécifié. |
{{Heure||32|15}} |
32 min 15 s 120 min 35 s |
Cas des durées inférieures à une heure, ou des durées exprimées en minutes ou en secondes. |
{{Heure||1|15|380}}{{Heure||1|1|069}} |
1 min 15 s 380 1 min 1 s 069 |
Cas généralement utilisé pour indiquer un temps dans le cadre d'une compétition sportive. |
{{Heure|0|1|0}}{{Heure|1|0|1}} |
0 h 1 min 0 s 1 h 0 min 1 s |
Une infobulle apparaît sur les abréviations (h, min, s). |
{{Heure|22|34|fuseau=[[CEST]]}} |
22 h 34 CEST 13 h 9 PST |
Avec un fuseau horaire. Le texte est libre et l'ajout du lien est laissé à l'appréciation du contributeur. |
{{Heure|22|34|alignement=oui}} |
22 h 34 13 h 9 |
Ajoute un zéro invisible devant les nombres d'heures, minutes, secondes à un seul chiffre, afin de permettre un alignement correct, notamment dans les tableaux. |
TemplateData
Permet d’écrire facilement et de typographier correctement une heure ou une durée, exprimée en heures, voire minutes, secondes, centièmes de seconde le cas échéant.
| Paramètre | Description | Type | État | |
|---|---|---|---|---|
| heure(s) | 1 | Nombre d'heures
| Nombre | suggéré |
| minute(s) | 2 | Nombre de minutes.
| Nombre | suggéré |
| seconde(s) | 3 | Nombre de secondes.
| Nombre | facultatif |
| centième(s) de seconde | 4 | Nombre de centièmes de seconde.
| Nombre | facultatif |
| fuseau horaire | fuseau |
| Chaîne | facultatif |
| forcer « min » | durée | Permet, s'il vaut « oui », de forcer l'écriture de « min » derrière le nombre des minutes lorsqu'il y a un nombre d'heures mais pas un nombre de secondes.
| Chaîne | facultatif |
| forcer alignement | alignement | Permet, s'il vaut « oui », d'ajouter un zéro invisible devant les nombres d'heures, minutes, secondes à un seul chiffre, afin de permettre un alignement correct, notamment dans les tableaux.
| Chaîne | facultatif |