datetime2 (24mar15)

git-svn-id: svn://tug.org/texlive/trunk@36615 c570f23f-e606-0410-a88d-b1316a301751

13 files changed, 421 insertions, 0 deletions

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
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/datetime2/datetime2.pdf
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
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-babel.pdf
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
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-calc.pdf
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
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-filedate.pdf
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
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-hyperref.pdf
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
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/datetime2/samples/datetime2-sample-styles.pdf
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}