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 11:59] – Regroupement de deux pages (une française, une anglaise) avant traduction. 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 inclure l'heure dans un document ? ======
+====== Comment insérer l'heure dans un document? ======
-Cette page traite de la question de l'affichage de l'heure mais certaines extensions traitent aussi la question de la date (par exemple [[ctanpkg>datetime|datetime]] et [[ctanpkg>srctime|srctime]]). (FIXME // Créer une page pour les questions de date//)
+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 (à la manière anglaise, au format sur 12 heures).
+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}
+  \pagestyle{empty}
+\begin{document}
+Il est \now.
+\end{document}
+</latexdoc>
+</WRAP>
+<WRAP clear />
-===== Avec l'extension daytime =====
+===== Avec l'extension “daytime” =====
- \daytime and \Daytime to print times,
+L'extension [[ctanpkg>daytime]] propose une solution similaire à la précédente avec une possibilité de variante sur l'écriture de l'heure:
-===== Avec l'extension srctime =====
+<WRAP column 50ex>
+<code latex>
+\documentclass{report}
+  \usepackage{daytime}
-FIXME The [[ctanpkg>scrtime|scrtime]] package (part of the compendious [[ctanpkg>KOMA-Script|KOMA-Script]] bundle) takes a package option (''12h'' or ''24h'') to specify how times are to be printed.  The command ''\thistime'' then prints the time appropriately (though there's no //am// or //pm// in ''12h'' mode).  The ''\thistime'' command also takes an optional argument, the character to separate the hours and minutes: the default is of course '':''.
+\begin{document}
+Il est \daytime, \Daytime.
+\end{document}
+</code>
+</WRAP>
+<WRAP column 30ex>
+<latexdoc>
+\documentclass{report}
+  \usepackage{daytime}
+  \pagestyle{empty}
+\begin{document}
+Il est \daytime, autrement dit \Daytime.
+\end{document}
+</latexdoc>
+</WRAP>
+<WRAP clear />
-===== Avec l'extension datetime =====
+===== Avec l'extension “srctime” =====
-FIXME The [[ctanpkg>datetime|datetime]] package defines two time-printing functions: ''\xxivtime'' (for 24-hour time), ''\ampmtime'' (for 12-hour time) and ''\oclock'' (for time-as-words, albeit a slightly eccentric set of words).
+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 :
+  * dans le cas de l'option « ''12h'' », les mentions « am » et « pm » ne sont pas affichées ;
+  * cette commande peut d'ailleurs prendre un argument optionnel pour préciser ce qui sépare les heures des minutes. Par défaut, ce sera « '':'' » ;
+  * sa version étoilée supprime le zéro parfois en trop des minutes.
+<WRAP column 50ex>
 <code latex>
 \documentclass{report}
-\usepackage{datetime}
+  \usepackage{scrtime}
 \begin{document}
-Le package \texttt{datetime} parle anglais. Toutefois, cela ne serait pas bien
+Il est \thistime[ heures ] minutes.
-compliqué à traduire...
+\end{document}
+</code>
+</WRAP>
+<WRAP column 30ex>
+<latexdoc>
+\documentclass{report}
+  \usepackage{scrtime}
+  \pagestyle{empty}
+\begin{document}
+Il est \thistime[ heures ] minutes.
+\end{document}
+</latexdoc>
+</WRAP>
+<WRAP clear />
-Nous sommes le \today. Si l'on veut faire plus fran\c cais, on peut utiliser
+===== Avec l'extension “datetime” =====
-\ddmmyyyydate\today.
-Mais quelle heure est-il donc ? Il est \xxivtime (c'est-à-dire \ampmtime).
+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]] (à 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{datetime}
+\begin{document}
+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}
-===== Sans extension =====
+\begin{document}
+Il est \xxivtime, c'est-à-dire \ampmtime{}
+ou \oclock.
+\end{document}
+</latexdoc>
-On peut décider de mettre soi-même en forme le résultat de la commande ''\time''. Voici un exemple de code traitant ce point :
+(nbsp)
-FIXME TeX has a primitive register that contains "the number of minutes since midnight"; with this knowledge it's a moderately simple programming job to print the time (one that no self-respecting Plain TeX user would bother with anyone else's code for).
+Si on reste en anglais, le résultat est plus satisfaisant:
+<latexdoc>
+\documentclass{report}
+  \usepackage{datetime}
+  \pagestyle{empty}
-FIXME However, LaTeX provides no primitive for "time", so the non-programming LaTeX user needs help.
+\begin{document}
+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 =====
+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}
 \makeatletter
 \def\timenow{\@tempcnta\time
@@ Ligne 60: / Ligne 187: @@
   \string~:\ifnum10>\@tempcnta0\fi\number\@tempcnta}
 \makeatother
+\begin{document}
 Il est \timenow.
+\end{document}
 </code>
+</WRAP>
+<WRAP column 30ex>
+<latexdoc>
+\documentclass{report}
+\makeatletter
+\def\timenow{\@tempcnta\time
+  \@tempcntb\@tempcnta
+  \divide\@tempcntb60
+  \ifnum10>\@tempcntb0\fi\number\@tempcntb
+  \multiply\@tempcntb60
+  \advance\@tempcnta-\@tempcntb
+  \string:\ifnum10>\@tempcnta0\fi\number\@tempcnta}
+\makeatother
+\pagestyle{empty}
+\begin{document}
+Il est \timenow.
+\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)
 }}