Différences

Ci-dessous, les différences entre deux révisions de la page.

--- composition:texte:mots:inserer_l_heure_dans_un_document [2020/12/12 14:35] – Fin de la traduction et ajout d'exemples. yannick.tanguy
+++ 3_composition:texte:mots:inserer_l_heure_dans_un_document [2021/04/18 09:52] (Version actuelle) – Mention de "datetime2". jejust
@@ Ligne 1: / Ligne 1: @@
-====== Comment insérer l'heure dans un document ? ======
+====== Comment insérer l'heure dans un document? ======
-Cette page traite de la question de l'affichage de [[https://fr.wikipedia.org/wiki/Heure|l'heure]]. Une page est par ailleurs dédiée à la question « [[composition:texte:mots:inserer_la_date_dans_un_document|Comment insérer la date dans un document ?]] ».
+Cette page traite de la question de l'affichage de [[wpfr>Heure|l'heure]]. Une page est par ailleurs dédiée à la question « [[3_composition:texte:mots:inserer_la_date_dans_un_document|Comment insérer la date dans un document ?]] ».
-===== Avec l'extension time =====
+===== Avec l'extension “time” =====
-L'extension [[ctanpkg>time|time]] propose une fonction affichant l'heure en notation anglaise.
+L'extension [[ctanpkg>time]] propose une fonction affichant l'heure en notation anglaise.
+<WRAP column 50ex>
 <code latex>
 \documentclass{report}
-\usepackage{time}
+  \usepackage{time}
 \begin{document}
 Il est \now.
 \end{document}
 </code>
+</WRAP>
+<WRAP column 30ex>
 <latexdoc>
 \documentclass{report}
-\usepackage{time}
+  \usepackage{time}
-\pagestyle{empty}
+  \pagestyle{empty}
 \begin{document}
@@ Ligne 24: / Ligne 27: @@
 \end{document}
 </latexdoc>
+</WRAP>
+<WRAP clear />
-===== Avec l'extension daytime =====
+===== Avec l'extension “daytime” =====
-L'extension [[ctanpkg>daytime|daytime]] propose une solution similaire à la précédente avec une possibilité de variante sur l'écriture de l'heure.
+L'extension [[ctanpkg>daytime]] propose une solution similaire à la précédente avec une possibilité de variante sur l'écriture de l'heure:
+<WRAP column 50ex>
 <code latex>
 \documentclass{report}
-\usepackage{daytime}
+  \usepackage{daytime}
 \begin{document}
 Il est \daytime, \Daytime.
 \end{document}
 </code>
+</WRAP>
+<WRAP column 30ex>
 <latexdoc>
 \documentclass{report}
-\usepackage{daytime}
+  \usepackage{daytime}
-\pagestyle{empty}
+  \pagestyle{empty}
 \begin{document}
 Il est \daytime, autrement dit \Daytime.
 \end{document}
 </latexdoc>
+</WRAP>
+<WRAP clear />
-===== Avec l'extension srctime =====
+===== Avec l'extension “srctime” =====
 L'extension [[ctanpkg>scrtime|scrtime]] (qui appartient à l'ensemble [[ctanpkg>KOMA-Script|KOMA-Script]]) peut également restituer l'heure. Elle dispose d'une option d'extension (« ''12h'' » ou « ''24h'' », cette dernière étant la valeur par défaut) pour préciser comme l'afficher. La commande ''\thistime'' affiche l'heure ainsi souhaitée, sachant que :
@@ Ligne 55: / Ligne 64: @@
   * sa version étoilée supprime le zéro parfois en trop des minutes.
+<WRAP column 50ex>
 <code latex>
 \documentclass{report}
-\usepackage{scrtime}
+  \usepackage{scrtime}
 \begin{document}
 Il est \thistime[ heures ] minutes.
 \end{document}
 </code>
+</WRAP>
+<WRAP column 30ex>
 <latexdoc>
 \documentclass{report}
-\usepackage{scrtime}
+  \usepackage{scrtime}
-\pagestyle{empty}
+  \pagestyle{empty}
 \begin{document}
@@ Ligne 72: / Ligne 84: @@
 \end{document}
 </latexdoc>
+</WRAP>
+<WRAP clear />
-===== Avec l'extension datetime =====
+===== Avec l'extension “datetime” =====
-L'extension [[ctanpkg>datetime|datetime]] définit trois fonctions pour les heures :
+L'extension [[ctanpkg>datetime]] définit trois fonctions pour les heures :
   * ''\xxivtime'' pour le format 24 heures ;
   * ''\ampmtime'' pour le format 12 heures ;
-  * ''\oclock'' pour un format texte mais, malgré une prise en compte de [[ctanpkg>babel|babel]] (à placer avant l'appel à [[ctanpkg>datetime|datetime]]), le résultat n'est clairement pas adapté. Il doit être réservé à la langue anglaise.
+  * ''\oclock'' pour un format texte mais, malgré une prise en compte de [[ctanpkg>babel]] (à placer avant l'appel à [[ctanpkg>datetime]]), le résultat n'est clairement pas adapté. Il doit être réservé à la langue anglaise.
+<WRAP column 50ex>
 <code latex>
 \documentclass{report}
-\usepackage[french]{babel}
+  \usepackage[french]{babel}
-\usepackage{datetime}
+  \usepackage{datetime}
 \begin{document}
-Il est \xxivtime, c'est-à-dire \ampmtime{} ou \oclock.
+Il est \xxivtime, c'est-à-dire \ampmtime{}
+ou \oclock.
 \end{document}
 </code>
+</WRAP>
+<WRAP column 50ex>
+<latexdoc>
+\documentclass{report}
+  \usepackage[french]{babel}
+  \usepackage{datetime}
+  \pagestyle{empty}
+\begin{document}
+Il est \xxivtime, c'est-à-dire \ampmtime{}
+ou \oclock.
+\end{document}
+</latexdoc>
+(nbsp)
+Si on reste en anglais, le résultat est plus satisfaisant:
 <latexdoc>
 \documentclass{report}
-\usepackage[french]{babel}
+  \usepackage{datetime}
-\usepackage{datetime}
+  \pagestyle{empty}
-\pagestyle{empty}
 \begin{document}
-Il est \xxivtime, c'est-à-dire \ampmtime{} ou \oclock.
+Il est \xxivtime, c'est-à-dire \ampmtime{}
+ou \oclock.
 \end{document}
 </latexdoc>
+</WRAP>
+<WRAP clear />
+===== Avec l'extension “datetime2” =====
+L'extension [[ctanpkg>datetime2]] est une réimplémentation complète de [[ctanpkg>datetime]],
+par la même auteure, Nicola Talbot. Cette réécriture a permis de proposer un ensemble
+de macros complètement développables, donc utilisables partout dans votre document,
+mais n'a pas conservé les noms des anciennes commandes.
+Si vous souhaitez seulement l'heure courante, utilisez ''\DTMcurrenttime'':
+<WRAP column 50ex>
+<code latex>
+\documentclass{report}
+  \usepackage[french]{babel}
+  \usepackage{datetime2}
+\begin{document}
+Il est \DTMcurrenttime{}.
+\end{document}
+</code>
+</WRAP>
+<WRAP column 50ex>
+<latexdoc>
+\documentclass{report}
+  \usepackage[french]{babel}
+  \usepackage{datetime2}
+  \pagestyle{empty}
+\begin{document}
+Il est \DTMcurrenttime{}.
+\end{document}
+</latexdoc>
+</WRAP>
+<WRAP clear />
 ===== Sans extension =====
-Lrimitive ''\time'' contient le nombre de minutes écoulées depuis minuit. Avec un peu de programmation, il est possible d'en tirer l'heure. Voici un exemple de code permettant cette conversion :
+La primitive ''\time'' contient le nombre de minutes écoulées depuis minuit. Avec un peu de programmation, il est possible d'en tirer l'heure. Voici un exemple de code permettant cette conversion :
+<WRAP column 56ex>
 <code latex>
 \documentclass{report}
@@ Ligne 116: / Ligne 187: @@
   \string~:\ifnum10>\@tempcnta0\fi\number\@tempcnta}
 \makeatother
 \begin{document}
 Il est \timenow.
 \end{document}
 </code>
+</WRAP>
+<WRAP column 30ex>
 <latexdoc>
 \documentclass{report}
@@ Ligne 138: / Ligne 211: @@
 \end{document}
 </latexdoc>
+</WRAP>
+<WRAP clear />
------
+-----
 //Source:// [[faquk>FAQ-time|Printing the time]]
-{{htmlmetatags>metatag-keywords=(LaTeX,heure,mise en forme)
+{{htmlmetatags>metatag-keywords=(LaTeX,heure,mise en forme,calcul de l'heure)
 metatag-og:title=(Comment inclure l'heure dans un document)
 metatag-og:site_name=(FAQ LaTeX francophone)
 }}