Modèle:Heure/Documentation

2013-11-24T03:15:42Z

78.251.243.23 : Paramètre "durée" avec accent également pris en charge depuis modification d'il y a quelques minutes

{{Sous-page de documentation}}
Le modèle '''<nowiki>{{Heure}}</nowiki>''' permet d’écrire facilement et de typographier correctement une heure (voir les [[Heure#Usages conventionnels|usages conventionnels]]). Par rapport à une écriture directe, ses avantages sont :
* corriger les erreurs de typographie courantes, comme « 22h34 » à la place de « {{Heure|22|34}} » ;
* éviter un retour à la ligne automatique entre les nombres et le « h », comme dans « 22 h 34 » en fin de ligne.

== Syntaxe ==
* <tt><nowiki>{{</nowiki>Heure|''heures''<nowiki>}}</nowiki></tt>
* <tt><nowiki>{{</nowiki>Heure|''heures''|''minutes''<nowiki>}}</nowiki></tt>
* <tt><nowiki>{{</nowiki>Heure|''heures''|''minutes''|durée=oui<nowiki>}}</nowiki></tt>
* <tt><nowiki>{{</nowiki>Heure|''heures''|''minutes''|''secondes''<nowiki>}}</nowiki></tt>
* <tt><nowiki>{{</nowiki>Heure|''heures''|''minutes''|''secondes''|''centièmes de secondes''<nowiki>}}</nowiki></tt>
* <tt><nowiki>{{</nowiki>Heure||''minutes''|''secondes''<nowiki>}}</nowiki></tt>

== Exemples d’utilisation ==

{| class="wikitable"
|-
! style="width:180px"|Syntaxe
! Résultat
! Commentaire
|-
| <code><nowiki>{{Heure|22}}</nowiki> <nowiki>{{Heure|8}}</nowiki></code> || {{Heure|22}} {{Heure|8}} || Cas d’utilisation minimale qui ne doit pas être utilisé dans un texte où la typographie doit être sous la forme « {{unité|22|heures}} » ou « {{unité|8|heures}} ».
|-
| <code><nowiki>{{Heure|22|34}}</nowiki> <nowiki>{{Heure|13|9}}</nowiki></code> || {{Heure|22|34}} {{Heure|13|9}} || Cas d’utilisation classique. Note : d’après les règles de typographie de l'[[Office québécois de la langue française|OQLF]]<ref>[http://66.46.185.79/bdl/gabarit_bdl.asp?t1=1&id=1516 Office québécois de la langue française] (mais cet usage conventionnel n'est pas suivi par tous les codes typographiques, voir [[heure#Usages conventionnels|heure]].</ref>, on n’ajoute pas de zéro devant le nombre des heures ni devant celui des minutes quand ceux-ci sont inférieurs à dix.
|-
| <code><nowiki>{{Heure|22|34|durée=oui}}</nowiki></code> || {{Heure|22|34|durée=oui}} || 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é « {{Abréviation discrète|min|minute}} ».
|-
| <code><nowiki>{{Heure|22|34|45}}</nowiki> <nowiki>{{Heure|11|4|9}}</nowiki></code> || {{Heure|22|34|45}} {{Heure|11|4|9}} || Cas où le nombre de secondes est spécifié.
|-
| <code><nowiki>{{Heure||32|15}}</nowiki> <nowiki>{{Heure||120|}}</nowiki> <nowiki>{{Heure|||35}}</nowiki></code> || {{Heure||32|15}} {{Heure||120|}} {{Heure|||35}} || Cas des durées inférieures à une heure, ou des durées exprimées en minutes ou en secondes.
|-
| <code><nowiki>{{Heure||1|15|380}}</nowiki></code> <code><nowiki>{{Heure||1|1|069}}</nowiki></code> || {{Heure||1|15|380}} {{Heure||1|1|069}} || Cas généralement utilisé pour indiquer un temps dans le cadre d'une compétition sportive.
|}

== TemplateData ==
<templatedata>
{
"description": "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.",
"params": {
"1": {
"label": "heure(s)",
"description": "Nombre d'heures",
"type": "number",
"required": true
},
"2": {
"label": "minute(s)",
"description": "Nombre de minutes.",
"type": "number",
"required": false
},
"3": {
"label": "seconde(s)",
"description": "Nombre de secondes.",
"type": "number",
"required": false
},
"4": {
"label": "centième(s) de seconde",
"description": "Nombre de centièmes de seconde.",
"type": "number",
"required": false
},
"durée": {
"label": "forcer « min »",
"description": "Permet, s'il vaut « oui », de forcer l'écriture de « min » derrière le nombre des minutes lorsqu'il n'y a pas de secondes.",
"type": "string",
"required": false
}
}
}
</templatedata>

==Notes et références ==
<references/>

== Voir aussi ==
* {{m|Unité}}
* [[Espace insécable]], obtenue par « &nbsp; » dans MediaWiki : évite une rupture de ligne sur une [[espace (typographie)|espace]].
* {{m|nobr}} : évite une rupture de ligne dans une expression.
* {{en}} [[mw:Help:Magic words#Formatting|Aide de « formatnum » sur Meta]].
<includeonly>

[[Catégorie:Modèle de formatage|Heure]]
</includeonly>

Baripedia - Contributions [fr]

Modèle:Heure/Documentation