From d72bcfb61c95b523b5bc8e1573c2f45f0dfa0464 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Tue, 24 Mar 2015 21:19:48 +0000 Subject: datetime2 (24mar15) git-svn-id: svn://tug.org/texlive/trunk@36615 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/datetime2/CHANGES | 2 + Master/texmf-dist/doc/latex/datetime2/README | 14 ++ .../texmf-dist/doc/latex/datetime2/datetime2.pdf | Bin 0 -> 473227 bytes .../datetime2/samples/datetime2-sample-babel.pdf | Bin 0 -> 72758 bytes .../datetime2/samples/datetime2-sample-babel.tex | 84 ++++++++++++ .../datetime2/samples/datetime2-sample-calc.pdf | Bin 0 -> 28791 bytes .../datetime2/samples/datetime2-sample-calc.tex | 76 +++++++++++ .../samples/datetime2-sample-filedate.pdf | Bin 0 -> 16716 bytes .../samples/datetime2-sample-filedate.tex | 23 ++++ .../samples/datetime2-sample-hyperref.pdf | Bin 0 -> 61838 bytes .../samples/datetime2-sample-hyperref.tex | 81 ++++++++++++ .../datetime2/samples/datetime2-sample-styles.pdf | Bin 0 -> 27073 bytes .../datetime2/samples/datetime2-sample-styles.tex | 141 +++++++++++++++++++++ 13 files changed, 421 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/datetime2/CHANGES create mode 100644 Master/texmf-dist/doc/latex/datetime2/README create mode 100644 Master/texmf-dist/doc/latex/datetime2/datetime2.pdf create mode 100644 Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-babel.pdf create mode 100644 Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-babel.tex create mode 100644 Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-calc.pdf create mode 100644 Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-calc.tex create mode 100644 Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-filedate.pdf create mode 100644 Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-filedate.tex create mode 100644 Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-hyperref.pdf create mode 100644 Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-hyperref.tex create mode 100644 Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-styles.pdf create mode 100644 Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-styles.tex (limited to 'Master/texmf-dist/doc/latex/datetime2') diff --git a/Master/texmf-dist/doc/latex/datetime2/CHANGES b/Master/texmf-dist/doc/latex/datetime2/CHANGES new file mode 100644 index 00000000000..0c3875f169b --- /dev/null +++ b/Master/texmf-dist/doc/latex/datetime2/CHANGES @@ -0,0 +1,2 @@ +1.0 (2015-03-24) : + * Initial Release diff --git a/Master/texmf-dist/doc/latex/datetime2/README b/Master/texmf-dist/doc/latex/datetime2/README new file mode 100644 index 00000000000..c8973be10f4 --- /dev/null +++ b/Master/texmf-dist/doc/latex/datetime2/README @@ -0,0 +1,14 @@ +LaTeX Package : datetime2 v1.0 + +Last Modified : 2015-03-24 + +Author : Nicola Talbot + +The datetime2 package replaces the datetime package, which is now +obsolete. + +This material is subject to the LaTeX Project Public License. +See http://www.ctan.org/license/lppl1.3 for the details of that license. + +http://www.dickimaw-books.com/ + diff --git a/Master/texmf-dist/doc/latex/datetime2/datetime2.pdf b/Master/texmf-dist/doc/latex/datetime2/datetime2.pdf new file mode 100644 index 00000000000..4ff58e5fdf9 Binary files /dev/null and b/Master/texmf-dist/doc/latex/datetime2/datetime2.pdf differ diff --git a/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-babel.pdf b/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-babel.pdf new file mode 100644 index 00000000000..9cfe2b0d41a Binary files /dev/null and b/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-babel.pdf differ diff --git a/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-babel.tex b/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-babel.tex new file mode 100644 index 00000000000..85c7dfadd47 --- /dev/null +++ b/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-babel.tex @@ -0,0 +1,84 @@ +% This file is public domain. + +% This document requires the datetime2-english module to be +% installed (in addition to the datetime2 package). +% arara: pdflatex +\documentclass[british,american,australian,canadian,newzealand,en-GG,en-JE,en-IM,en-MT,en-IE]{article} + +\usepackage{babel} +\usepackage[datesep=/,showzoneminutes=false,useregional]{datetime2} +\usepackage[colorlinks]{hyperref} + +%\DTMlangsetup{mapzone=false} + +\DTMsavetimestamp{mydate}{2014-06-03T12:45:02+01:00} +\DTMsavetimestamp{mydate2}{2015-03-20T08:05:09+00:00} +\DTMsavetimestamp{mydate3}{2014-12-15T23:55:49-06:00} +\DTMsavetimestamp{mydate4}{2014-01-27T12:05:00+09:00} +\DTMsavetimestamp{mydate5}{2013-11-28T02:05:00+12:00} + +% This will clear the BST mapping when the regional styles are set. +% The en-GB (british) style will then set it to BST. +\renewcommand*{\DTMresetzones}{\DTMclearmap{01}{00}} + +\begin{document} +\tableofcontents + +% Define command to test each region +\newcommand{\testregion}[1]{% + \ifcsdef{date#1}{\selectlanguage{#1}}{\DTMsetstyle{#1}}% + + \section{#1} + + Today: \today. + + Now: \DTMnow. + + \subsection{\DTMuse{mydate}} + Saved Date (\texttt{mydate}): \DTMusedate{mydate} + Saved time (\texttt{mydate}): \DTMusetime{mydate}. + \typeout{Date (#1): \DTMusedate{mydate}} + + \subsection{\DTMuse{mydate2}} + Saved Date (\texttt{mydate2}): \DTMusedate{mydate2} + Saved time (\texttt{mydate2}): \DTMusetime{mydate2}. + \typeout{Date (#1): \DTMusedate{mydate2}} + + \subsection{\DTMuse{mydate3}} + Saved Date (\texttt{mydate3}): \DTMusedate{mydate3} + Saved time (\texttt{mydate3}): \DTMusetime{mydate3}. + \typeout{Date (#1): \DTMusedate{mydate3}} + + \subsection{\DTMuse{mydate4}} + Saved Date (\texttt{mydate4}): \DTMusedate{mydate4} + Saved time (\texttt{mydate4}): \DTMusetime{mydate4}. + \typeout{Date (#1): \DTMusedate{mydate4}} + + \subsection{\DTMuse{mydate5}} + Saved Date (\texttt{mydate5}): \DTMusedate{mydate5} + Saved time (\texttt{mydate5}): \DTMusetime{mydate5}. + \typeout{Date (#1): \DTMusedate{mydate5}} +} + +\testregion{british} + +\testregion{american} + +\testregion{australian} + +\testregion{canadian} + +\testregion{newzealand} + +% no official babel language for these regions as far as I can tell: +\testregion{en-GG} + +\testregion{en-JE} + +\testregion{en-IM} + +\testregion{en-MT} + +\testregion{en-IE} + +\end{document} diff --git a/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-calc.pdf b/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-calc.pdf new file mode 100644 index 00000000000..835df65c797 Binary files /dev/null and b/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-calc.pdf differ diff --git a/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-calc.tex b/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-calc.tex new file mode 100644 index 00000000000..decea34b1db --- /dev/null +++ b/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-calc.tex @@ -0,0 +1,76 @@ +% This file is public domain. + +% arara: pdflatex +\documentclass{article} + +\usepackage[calc]{datetime2} + +\begin{document} + +\DTMsavejulianday{mydate}{2457023} +\DTMsavedate{mydate2}{2014-06-20} + +Date: \DTMusedate{mydate}. + +\newcount\myct +\DTMsaveddatetojulianday{mydate}{\myct} + +Julian day number: \number\myct. + +\DTMsaveddateoffsettojulianday{mydate}{2}{\myct} + +Julian day number (offset+2): \number\myct. + +Is \texttt{mydate2} (\DTMusedate{mydate2}) before +\texttt{mydate} (\DTMusedate{mydate})? +\DTMifdate + {mydate2} + {at most= + \DTMfetchyear{mydate}-\DTMfetchmonth{mydate}-\DTMfetchday{mydate}} + {yes}{no}. + +Is \texttt{mydate2} (\DTMusedate{mydate2}) after +\texttt{mydate} (\DTMusedate{mydate})? +\DTMifdate + {mydate2} + {at least= + \DTMfetchyear{mydate}-\DTMfetchmonth{mydate}-\DTMfetchday{mydate}} + {yes}{no}. + +\DTMsaveddatediff{mydate}{mydate2}{\myct} + +\DTMusedate{mydate} is +\ifnum\myct=0 + the same day as +\else + \ifnum\myct<0 + \number-\myct\space day\ifnum\myct<-1s\fi\space before + \else + \number\myct\space day\ifnum\myct>1s\fi\space after + \fi +\fi +\DTMusedate{mydate2}. + +Original date: 2014-06-3 20:45:00 +06:00 + +\DTMsaveaszulutime{mydate}{2014}{6}{3}{20}{45}{0}{6}{0} +UTC+00:00 date: \DTMuse{mydate}. + +\DTMsavetimestamp{mydate}{2014-05-01T03:55:00 -06:00} +Original date: \DTMuse{mydate}. + +\DTMtozulu{mydate}{mydate2} +UTC+00:00: \DTMuse{mydate2}. + +Offset: \DTMdate{2015-03-30+4}. + +Last: \DTMdate{2015-02-last}. + +Last with offset: \DTMdate{2015-02-last+-2}. + +Saved date with offset +\DTMsavedate{offset}{2015-02-last+-2} + +Use date: \DTMusedate{offset}. + +\end{document} diff --git a/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-filedate.pdf b/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-filedate.pdf new file mode 100644 index 00000000000..ee9899c195b Binary files /dev/null and b/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-filedate.pdf differ diff --git a/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-filedate.tex b/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-filedate.tex new file mode 100644 index 00000000000..bf9df37ce82 --- /dev/null +++ b/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-filedate.tex @@ -0,0 +1,23 @@ +% This file is public domain. + +% arara: pdflatex +% May also work with lualatex on some platforms (such as Linux) +% but the file mod date is not supported with xelatex. +% (The time zone %z format with Lua may not work on some platforms.) +% arara: pdflatex +\documentclass{article} + +\usepackage{datetime2} + +\begin{document} +Current date and time: \DTMnow. + +\DTMsavefilemoddate{filemod}{\jobname.tex} + +File modification date: \DTMuse{filemod}. + +Save current date and time. +\DTMsavenow{mydate} + +Now use it: \DTMuse{mydate}. +\end{document} diff --git a/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-hyperref.pdf b/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-hyperref.pdf new file mode 100644 index 00000000000..ca3b1db5b12 Binary files /dev/null and b/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-hyperref.pdf differ diff --git a/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-hyperref.tex b/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-hyperref.tex new file mode 100644 index 00000000000..ed881d5e029 --- /dev/null +++ b/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-hyperref.tex @@ -0,0 +1,81 @@ +% This file is public domain. +% This document additionally requires the datetime2-english module +% to be installed. + +% arara: pdflatex +% arara: pdflatex +\documentclass[en-GB,en-US,en-AU]{article} + +\usepackage[datesep=/,showzoneminutes=false]{datetime2} +\usepackage[colorlinks]{hyperref} + +\DTMsetup{showdow} + +\DTMsavetimestamp{mydate}{2014-06-03T12:45:02+01:00} + +\begin{document} +\tableofcontents + +The use of \verb|\typeout| is to test the expansion in the event +that the date/time needs to be written to an external file. +Use +\texttt{\href{http://www.dickimaw-books.com/latex/novices/html/texdoc.html}{texdoc} datetime2} to read the main user manual for +the \texttt{datetime2} package and use \texttt{texdoc +datetime2-english} for the English module documentation. + +\section{Default date: \today} + +Today: \today. Time: \DTMcurrenttime. Zone: \DTMcurrentzone. + +Now: \DTMnow. + +TWO DIGITS: \DTMtwodigits{2014}. \DTMtwodigits{2999}. +\DTMtwodigits{-2}. + +\typeout{Date Stamp (Default): \DTMnow} + +Saved date: \DTMusedate{mydate}. +Saved time: \DTMusetime{mydate}. + +Saved date-time: \DTMuse{mydate}. + +\typeout{Date Stamp (Default): \DTMuse{mydate}} + +\section{Default time: \DTMusetime{mydate}} + +\DTMsetstyle{iso} + +ISO: \DTMnow. +\typeout{Date Stamp (ISO): \DTMnow} + +Saved date: \DTMuse{mydate}. +\typeout{Date Stamp (ISO): \DTMuse{mydate}} + +\DTMsetstyle{en-GB} +\section{(GB) \DTMusedate{mydate}} + +en-GB: \DTMnow. +\typeout{Date Stamp (GB): \DTMnow} + +Saved date: \DTMuse{mydate}. +\typeout{Date Stamp (GB): \DTMuse{mydate}} + +\DTMsetstyle{en-US} +\section{(US) \DTMusedate{mydate}} + +en-US: \DTMnow. +\typeout{Date Stamp (US): \DTMnow} + +Saved date: \DTMuse{mydate}. +\typeout{Date Stamp (US): \DTMuse{mydate}} + +\DTMsetstyle{en-AU} +\section{(AU) \DTMusedate{mydate}} + +en-AU: \DTMnow. +\typeout{Date Stamp (AU): \DTMnow} + +Saved date: \DTMuse{mydate}. +\typeout{Date Stamp (AU): \DTMuse{mydate}} + +\end{document} diff --git a/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-styles.pdf b/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-styles.pdf new file mode 100644 index 00000000000..a46dcc7e3e3 Binary files /dev/null and b/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-styles.pdf differ diff --git a/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-styles.tex b/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-styles.tex new file mode 100644 index 00000000000..6d11198794e --- /dev/null +++ b/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-styles.tex @@ -0,0 +1,141 @@ +% This file is public domain. +% This document additionally requires the datetime2-english module +% to be installed. + +% arara: pdflatex +\documentclass[english]{article} + +\usepackage{datetime2} + +%\DTMsetup{showseconds=false,datesep=/,timesep=.} + +\begin{document} +\DTMsavetimestamp{mydate}{2015-04-01T08:05:00+01:00} +\DTMsavetimestamp{mydate2}{2015-04-01T08:13:45+01:00} + +Default: \DTMnow. \DTMuse{mydate}. +\typeout{Date-Time (default): \DTMnow. \DTMuse{mydate}.} + +\DTMsetstyle{iso} + +ISO: \DTMnow. \DTMuse{mydate}. +\typeout{Date-Time (iso): \DTMnow. \DTMuse{mydate}.} + +\DTMsetstyle{pdf} + +PDF: \DTMnow. \DTMuse{mydate}. +\typeout{Date-Time (pdf): \DTMnow. \DTMuse{mydate}.} + +\DTMsetstyle{ddmmyyyy} + +ddmmyyyy: \DTMnow. \DTMuse{mydate}. +\typeout{Date-Time (ddmmyyyy): \DTMnow. \DTMuse{mydate}.} + +\DTMsetstyle{dmyyyy} + +dmyyyy: \DTMnow. \DTMuse{mydate}. +\typeout{Date-Time (dmyyyy): \DTMnow. \DTMuse{mydate}.} + +\DTMsetstyle{dmyy} + +dmyy: \DTMnow. \DTMuse{mydate}. +\typeout{Date-Time (dmyy): \DTMnow. \DTMuse{mydate}.} + +\DTMsetstyle{mmddyyyy} + +mmddyyyy: \DTMnow. \DTMuse{mydate}. +\typeout{Date-Time (mmddyyyy): \DTMnow. \DTMuse{mydate}.} + +\DTMsetstyle{mdyyyy} + +mdyyyy: \DTMnow. \DTMuse{mydate}. +\typeout{Date-Time (mdyyyy): \DTMnow. \DTMuse{mydate}.} + +\DTMsetstyle{mdyy} + +mdyy: \DTMnow. \DTMuse{mydate}. +\typeout{Date-Time (mdyy): \DTMnow. \DTMuse{mydate}.} + +\DTMsetstyle{yyyymd} + +yyyymd: \DTMnow. \DTMuse{mydate}. +\typeout{Date-Time (yyyymd): \DTMnow. \DTMuse{mydate}.} + +Testing time styles. + +\DTMsavetime{noon}{12:00:00} +\DTMsavetime{midnight1}{00:00:00} +\DTMsavetime{midnight2}{24:00:00} +\DTMsavetime{8am}{08:00:00} +\DTMsavetime{8pm}{20:00:00} +\DTMsavetime{1203}{12:03:00} +\DTMsavetime{2401}{24:01:00} +\DTMsavetime{0001}{00:01:00} + +\DTMsettimestyle{hmmss} + +hmmss: \DTMcurrenttime. \DTMusetime{mydate}. +\DTMusetime{mydate2}. +\DTMusetime{noon}. +\DTMusetime{midnight1}. +\DTMusetime{midnight2}. +\DTMusetime{8am}. +\DTMusetime{8pm}. +\DTMusetime{1203}. +\DTMusetime{2401}. +\DTMusetime{0001}. + +\typeout{Time (hmmss): \DTMcurrenttime. + \DTMusetime{mydate}. + \DTMusetime{mydate2}. + \DTMusetime{noon}. + \DTMusetime{midnight1}. + \DTMusetime{midnight2}. + \DTMusetime{8am}. + \DTMusetime{8pm}. + \DTMusetime{1203}. + \DTMusetime{2401}. + \DTMusetime{0001}. +} + +\DTMsettimestyle{englishampm} +ampm: \DTMcurrenttime. +\DTMusetime{mydate}. +\DTMusetime{mydate2}. +\DTMusetime{noon}. +\DTMusetime{midnight1}. +\DTMusetime{midnight2}. +\DTMusetime{8am}. +\DTMusetime{8pm}. +\DTMusetime{1203}. +\DTMusetime{2401}. +\DTMusetime{0001}. + +\typeout{Time (ampm): \DTMcurrenttime. +\DTMusetime{mydate}. +\DTMusetime{mydate2}. +\DTMusetime{noon}. +\DTMusetime{midnight1}. +\DTMusetime{midnight2}. +\DTMusetime{8am}. +\DTMusetime{8pm}. +\DTMusetime{1203}. +\DTMusetime{2401}. +\DTMusetime{0001}. +} + +\renewcommand*{\DTMenglishampmfmt}[1]{\protect\textsc{#1}} + +(ampm sc) \DTMcurrenttime. +\DTMusetime{mydate}. +\DTMusetime{mydate2}. +\DTMusetime{noon}. +\DTMusetime{midnight1}. +\DTMusetime{midnight2}. +\DTMusetime{8am}. +\DTMusetime{8pm}. +\DTMusetime{1203}. +\DTMusetime{2401}. +\DTMusetime{0001}. + +\end{document} -- cgit v1.2.3