diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/datetime/manual.html')
-rw-r--r-- | Master/texmf-dist/doc/latex/datetime/manual.html | 853 |
1 files changed, 853 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/datetime/manual.html b/Master/texmf-dist/doc/latex/datetime/manual.html new file mode 100644 index 00000000000..b94fed19019 --- /dev/null +++ b/Master/texmf-dist/doc/latex/datetime/manual.html @@ -0,0 +1,853 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> + +<!--Converted with jLaTeX2HTML 2002-2-1 (1.70) JA patch-2.0 +patched version by: Kenshi Muto, Debian Project. +* modified by: Shige TAKENO +LaTeX2HTML 2002-2-1 (1.70), +original version by: Nikos Drakos, CBLU, University of Leeds +* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan +* with significant contributions from: + Jens Lippmann, Marek Rouchal, Martin Wilck and others --> +<HTML> +<HEAD> +<TITLE>datetime.sty v2.46: Formatting Current Date and Time</TITLE> +<META NAME="description" CONTENT="datetime.sty v2.46: Formatting Current Date and Time"> +<META NAME="keywords" CONTENT="manual"> +<META NAME="resource-type" CONTENT="document"> +<META NAME="distribution" CONTENT="global"> + +<META NAME="Generator" CONTENT="jLaTeX2HTML v2002-2-1 JA patch-2.0"> +<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css"> + + +</HEAD> + +<BODY > +<A NAME="tex2html1" + HREF="http://theoval.cmp.uea.ac.uk/~nlct/">Dr Nicola Talbot</A> +| +<A NAME="tex2html2" + HREF="http://www.cmp.uea.ac.uk/">School of Computing Sciences</A> +| +<A NAME="tex2html3" + HREF="http://www.uea.ac.uk/">University of East Anglia</A> + +<P> + +<P> + + <H1 ALIGN="CENTER">datetime.sty v2.46: Formatting Current Date and +Time</H1> +<DIV> + +<P ALIGN="CENTER"><STRONG>N.L.C. Talbot</STRONG></P> +<P ALIGN="CENTER"><STRONG>25 May 2005</STRONG></P> +</DIV> + <BR> + +<H2><A NAME="SECTION00010000000000000000"> +Contents</A> +</H2> +<!--Table of Contents--> + +<UL> +<LI><A NAME="tex2html26" + HREF="manual.html#SECTION00020000000000000000">Introduction</A> +<LI><A NAME="tex2html27" + HREF="manual.html#SECTION00030000000000000000">Date Declarations</A> +<LI><A NAME="tex2html28" + HREF="manual.html#SECTION00040000000000000000">Time Commands</A> +<LI><A NAME="tex2html29" + HREF="manual.html#SECTION00050000000000000000">Formating Dates</A> +<LI><A NAME="tex2html30" + HREF="manual.html#SECTION00060000000000000000">Defining New Date Formats</A> +<LI><A NAME="tex2html31" + HREF="manual.html#SECTION00070000000000000000">Saving Dates</A> +<LI><A NAME="tex2html32" + HREF="manual.html#SECTION00080000000000000000">Predefined Names</A> +<LI><A NAME="tex2html33" + HREF="manual.html#SECTION00090000000000000000">Package Options</A> +<LI><A NAME="tex2html34" + HREF="manual.html#SECTION000100000000000000000">Multilingual Support</A> +<LI><A NAME="tex2html35" + HREF="manual.html#SECTION000110000000000000000">Configuration File</A> +<LI><A NAME="tex2html36" + HREF="manual.html#SECTION000120000000000000000">LaTeX2HTML styles</A> +<LI><A NAME="tex2html37" + HREF="manual.html#SECTION000130000000000000000">Contact Details</A> +</UL> +<!--End of Table of Contents--> +<H1><A NAME="SECTION00020000000000000000"> +Introduction</A> +</H1> + +The <TT>datetime</TT> package is a LaTeX2e package that +provides various different formats for <code>\today</code>, +and provides commands for displaying the current time. +If you only want the +time commands but not the date changing commands, you can pass +the option <TT>nodate</TT> to the package. + +<P> +Since version 2.4, the <TT>datetime</TT> package has been +separated into two packages: <TT>datetime</TT> and +<TT>fmtcount</TT>. When I originally created this package, +I defined the commands, <code>\ordinal</code> etc which could be used +in the definition of <code>\today</code>. Since then, I have extended +the number of commands available that can be used to display the +value of a LaTeX counter, however it seems more appropriate to +define all these counter-related commands in a separate package. +The <TT>fmtcount</TT> package is now distributed separately +from the <TT>datetime</TT> package, and will also need to +be installed. + +<P> +As from version 2.42, the <TT>datetime</TT> package is now +compatible with <TT>babel</TT>, however you must load the +<TT>datetime</TT> package <I>after</I> the <TT>babel</TT> package. For example: +<PRE> +\usepackage[francais]{babel} +\usepackage{datetime} +</PRE> + +<P> + +<H1><A NAME="SECTION00030000000000000000"> +Date Declarations</A> +</H1> + There are various declarations that change the effect of +<code>\today</code>. The change can be localised by placing the +declaration within a group. + +<P> + + <I>Day</I> <I>Month</I> <I>Year</I> formats: +<BR> +The declaration <code>\longdate</code> will redefine +<code>\today</code> to produce the current date displayed in the form +Wednesday 8<SUP>th</SUP> March, 2000 + if the package option <TT>dayofweek</TT> is used, or +8<SUP>th</SUP> March, 2000 if the package option + <TT>nodayofweek</TT> is used. +<BR> +The declaration <code>\shortdate</code> will redefine +<code>\today</code> to produce the current date displayed in the form +Wed 8<SUP>th</SUP> Mar, 2000 if the package option +<TT>dayofweek</TT> is used, or 8<SUP>th</SUP> Mar, 2000 +if the package option <TT>nodayofweek</TT> is used. +<BR> +The declaration <code>\ddmmyyyydate</code> will redefine +<code>\today</code> to produce + the current date displayed in the form 08/03/2000 +<BR> +The declaration <code>\dmyyyydate</code> will redefine +<code>\today</code> to produce + the current date displayed in the form 8/3/2000 +<BR> +The declaration <code>\ddmmyydate</code> will redefine +<code>\today</code> to produce + the current date displayed in the form 08/03/00 +<BR> +The declaration <code>\dmyydate</code> will redefine +<code>\today</code> to produce + the current date displayed in the form 8/3/00 +<BR> +The declaration <code>\textdate</code> will redefine +<code>\today</code> to produce the current date displayed in the form: +Wednesday the Eighth of March, Two Thousand if the package option +<TT>dayofweek</TT> is used, or Eighth of March, Two Thousand if +the package option <TT>nodayofweek</TT> is used. + +<P> + + <I>Month</I> <I>Day</I> <I>Year</I> formats: +<BR> +The declaration <code>\usdate</code> will redefine +<code>\today</code> to produce the current date displayed in the form +March 8, 2000. (As TeX and LaTeX do by default.) +<BR> +The declaration <code>\mmddyyyydate</code> will redefine +<code>\today</code> to produce the current date displayed in the form +03/08/2000 +<BR> +The declaration <code>\mdyyyydate</code> will redefine +<code>\today</code> to produce the current date displayed in the form +3/8/2000 +<BR> +The declaration <code>\mmddyydate</code> will redefine +<code>\today</code> to produce the current date displayed in the form +03/08/00 +<BR> +The declaration <code>\mdyydate</code> will redefine +<code>\today</code> to produce the current date displayed in the form +3/8/00 + +<P> +In addition, the declarations <code>\date</code><I>lang</I> are +available for all languages defined either by +calling <TT>babel</TT> prior to <TT>datetime</TT> or by +passing the language name as an option to <TT>datetime</TT>. +See <A HREF="#sec:newdate">later</A> +if you want to define your own customised date format. + +<P> +As from version 2.43, the numerical date formats (such as +<code>\ddmmyyyydate</code>) use the command +<code>\dateseparator</code> to separate the numbers. So, for example, +if you want to hyphens instead of slashes, you can do: +<PRE> +\renewcommand{\dateseparator}{-} +</PRE> + +<P> + +<H1><A NAME="SECTION00040000000000000000"> +Time Commands</A> +</H1> + + The current time is displayed using the command +<code>\currenttime</code>. + + The format can be changed using the declaration +<code>\settimeformat{</code><I>style</I><code>}</code>, + where <I>style</I> is the name of the format<A NAME="tex2html4" + HREF="#foot371"><SUP>1</SUP></A>. Available +formats are: +<DL> +<DT><STRONG>xxivtime</STRONG></DT> +<DD>Twenty-four hour time in the form 22:28 (Default) +</DD> +<DT><STRONG>ampmtime</STRONG></DT> +<DD>Twelve hour time in the form 10:28pm +</DD> +<DT><STRONG>oclock</STRONG></DT> +<DD>Displays the current time as a string, e.g. +Twenty-Eight minutes past Ten in the afternoon.<A NAME="tex2html5" + HREF="#foot131"><SUP>2</SUP></A> +</DD> +</DL> + +<P> +New time formats can be defined using the command: +<BR> +<BR><code>\newtimeformat{</code><I>name</I><code>}{</code><I>format</I><code>}</code> +<BR> +<BR> +where <I>name</I> is the name of the new format (used in +<code>\settimeformat</code>), and <I>format</I> is how to format the +time. Within <I>format</I> you can use the counters +<TT>HOUR</TT> (number of hours after midnight), <TT>MINUTE</TT> +(number of minutes past the hour), <TT>HOURXII</TT> (number of +hours after midnight/midday), <TT>TOHOUR</TT> (the next hour) + and <TT>TOMINUTE</TT> (number of minutes to the next hour), and +the corresponding commands: + <code>\THEHOUR</code>, +<code>\THEMINUTE</code>, +<code>\THEHOURXII</code>, +<code>\THETOHOUR</code> and +<code>\THETOMINUTE</code>. + +<P> +For example, to define a new time format that uses a dot instead of a colon: +<PRE> +\newtimeformat{dottime}{\twodigit{\THEHOUR}.\twodigit{\THEMINUTE}} +</PRE> +You then need to switch to this new format before you can use it: +<PRE> +\settimeformat{dottime} +\currenttime +</PRE> + +<P> +As from version 2.43, if you only want to change the separator, +you can simply redefine <code>\timeseparator</code> +instead of defining a new time format. For example: +<PRE> +\renewcommand{\timeseparator}{.} +</PRE> +The <TT>xxivtime</TT> format will now work like the <TT>dottime</TT> format defined above. + +<P> + +<H1><A NAME="SECTION00050000000000000000"> +Formating Dates</A> +</H1> + + The command <code>\pdfdate</code><A NAME="tex2html6" + HREF="#foot169"><SUP>3</SUP></A> prints the date in the format required for + PDF files, e.g. if the date is 1 May 2004 and time is + 22:02, <code>\pdfdate</code> will print 20040501220200. The reason +this date format is separate from all the others is because the +other form doesn't get properly expanded by PDFTeX. (This +command is defined regardless of whether the package option +<TT>nodate</TT> is called.) +Example: +<PRE> +\pdfinfo{ + /Author (Me) + /Title (A Sample Document) + /CreationDate (D:20040501215500) + /ModificationDate (D:\pdfdate) +} +</PRE> + +<P> +There are two commands that print the name of the current + month: + + <code>\monthname</code> prints the current month name in full, +e.g. August, and + + <code>\shortmonthname</code> prints the abbreviated month name, +e.g. Aug. Both <code>\monthname</code> and +<code>\shortmonthname</code> take an optional argument (a number from +1 to 12) if the name of a specific month is required. For +example, <code>\monthname[6]</code> will produced the output: June. + +<P> +The day of the week is computed using the algorithm documented at + <TT><A NAME="tex2html7" + HREF="http://userpages.wittenburg.edu/bshelburne/Comp150/DayOfWeek.htm">http://userpages.wittenburg.edu/bshelburne/Comp150/DayOfWeek.htm</A></TT>. + This algorithm works for any date between 1<SUP>st</SUP> +Jan, 1901 and 31<SUP>st</SUP> Dec, 2099. + The following macros display the day of week for a given date: + +<P> + + <code>\dayofweekname{</code><I>day</I><code>}{</code><I>month</I><code>}{</code><I>year</I><code>}</code> prints the + day of week for the specified date. For example, +<code>\dayofweekname{31}{10}{2002}</code> + will produce the output: Thursday. +<BR> + <code>\shortdayofweekname{</code><I>day</I><code>}{</code><I>month</I><code>}{</code><I>year</I><code>}</code> prints the abbreviated name for the + day of week for the specified date. For example +<BR> <code>\shortdayofweekname{31}{10}{2002}</code> +<BR> +will produce the output: Thu. + +<P> +The TeX conditional <code>\ifshowdow</code> can be used to determine + whether or not the option <TT>dayofweek</TT> has been passed to +the package. + For example: +<PRE> +\ifshowdow\dayofweekname{31}{10}{2002} \fi +</PRE> + will only display the day of week if the <TT>dayofweek</TT> +option was passed to <TT>datetime</TT>. + Alternatively, you can use David Carlisle's <TT>ifthen</TT> +package: +<PRE> +\ifthenelse{\boolean{showdow}}{\dayofweekname{31}{10}{2002} }{} +</PRE> + +<P> +The command <code>\ordinaldate{</code><I>number</I><code>}</code> +displays <I>number</I> as a date-type ordinal. If the +current language is English, this will simply pass +the argument to <code>\ordinalnum</code> (defined in the +<TT>fmtcount</TT> package), +if the current language is Breton, Welsh or French, a superscript +will only be added if <I>number</I> is 1, otherwise only +<I>number</I> will be displayed. + +<P> +The macro <code>\formatdate{</code><I>day</I><code>}{</code><I>month</I><code>}{</code><I>year</I><code>}</code><A NAME="tex2html8" + HREF="#foot373"><SUP>4</SUP></A> formats + the specified date according to the current format of +<code>\today</code><A NAME="tex2html9" + HREF="#foot374"><SUP>5</SUP></A>. (Arguments + must all be integers.) For example, in combination with +<code>\longdate</code>, the command +<BR><code>\formatdate{27}{9}{2004}</code> +<BR> +will produce the output: Monday 27<SUP>th</SUP> +September, 2004. + +<P> +You can ensure that a number is displayed with at least two +digits by using the command +<code>\twodigit{</code><I>num</I><code>}</code><A NAME="tex2html10" + HREF="#foot233"><SUP>6</SUP></A>. + This is of use if you want to define your own date or time +formats. + +<P> + +<H1><A NAME="SECTION00060000000000000000"></A><A NAME="sec:newdate"></A> +<BR> +Defining New Date Formats +</H1> + +<P> +New date formats can be defined using the command: +<BR> +<BR> <code>\newdateformat{</code><I>name</I><code>}{</code><I>format</I><code>}</code> +<BR> +<BR> +where <I>name</I> is the name of the new format, and + <I>format</I> is how to format the date. Within the + argument <I>format</I> you can use the commands <code>\THEDAY</code>, +<code>\THEMONTH</code> + and <code>\THEYEAR</code> to represent the relevant day, month and +year, or you can use the counters + <TT>DAY</TT>, <TT>MONTH</TT> and <TT>YEAR</TT> if you want to +use <code>\ordinal</code> etc. Once you have defined the + new date format, you can then switch to it using the declaration <code>\</code><I>name</I> + (i.e. the name you specified preceded by a backslash), and + subsequent calls to <code>\today</code> and <code>\formatdate</code> will +use your new format. + +<P> +For example, suppose you want to define a new date format called, + say, <TT>mydate</TT>, that will typeset the date in the form: +8-3-2002, + then you can do: +<PRE> +\newdateformat{mydate}{\THEDAY-\THEMONTH-\THEYEAR} +</PRE> + <code>\newdateformat</code> will then define the declaration +<code>\mydate</code> which can be used to + switch to your new format. In the following example, + two new date formats are defined, and they are then + selected to produce two different formats for the current date: +<PRE> +\newdateformat{dashdate}{% +\twodigit{\THEDAY}-\twodigit{\THEMONTH}-\THEYEAR} + +\newdateformat{usvardate}{% +\monthname[\THEMONTH] \ordinal{DAY}, \THEYEAR} + +Dash: \dashdate\today. +US: \usvardate\today. +</PRE> +If the current date is, say, 8th March, 2002, the above code will + produce the following: +Dash: 08-03-2002. +US: March 8<SUP>th</SUP>, 2002. + +<P> +Note that <code>\THEDAY</code> etc and <TT>DAY</TT> etc have no real +meaning outside <code>\newdateformat</code> (this is why they +are in uppercase). Incidentally, the <TT>dashdate</TT> format +is not really necessary, as you can achieve this format +using: +<PRE> +\renewcommand{\dateseparator}{-} +\ddmmyyyydate +</PRE> + +<P> +Another note: in the above code, <code>\ordinal</code> was +used to illustrate the use of the <TT>DAY</TT> counter. It +is better to use <code>\ordinaldate</code> instead: +<PRE> +\newdateformat{usvardate}{% +\monthname[\THEMONTH] \ordinaldate{\THEDAY}, \THEYEAR} +</PRE> + +<P> + +<H1><A NAME="SECTION00070000000000000000"> +Saving Dates</A> +</H1> + +<P> +It is possible to save a date for later use using the command: +<A NAME="tex2html11" + HREF="#foot266"><SUP>7</SUP></A> +<P> + +<code>\newdate{</code><I>name</I><code>}{</code><I>day</I><code>}{</code><I>month</I><code>}{</code><I>year</I><code>}</code> + +<P> +This date can later be displayed using the same format as that +used by <code>\formatdate</code> using the command: +<P> + +<code>\displaydate{</code><I>name</I><code>}</code> + +<P> +Individual elements of the date can be extracted using the +commands: +<P> + +<code>\getdateday{</code><I>name</I><code>}</code> +<P> + +<code>\getdatemonth{</code><I>name</I><code>}</code> +<P> + +<code>\getdateyear{</code><I>name</I><code>}</code> + +<P> + +<H1><A NAME="SECTION00080000000000000000"> +Predefined Names</A> +</H1> + +<P> +The following commands are defined by the <TT>datetime</TT> +package: + +<P> +<TABLE CELLPADDING=3> +<TR><TH ALIGN="LEFT"><B>Command Name </B></TH> +<TH ALIGN="LEFT"><B>Default Value</B></TH> +</TR> +<TR><TD ALIGN="LEFT"><code>\dateseparator</code></TD> +<TD ALIGN="LEFT"><code>/</code></TD> +</TR> +<TR><TD ALIGN="LEFT"><code>\timeseparator</code></TD> +<TD ALIGN="LEFT"><code>:</code></TD> +</TR> +<TR><TD ALIGN="LEFT"><code>\amname</code></TD> +<TD ALIGN="LEFT"><TT>am</TT></TD> +</TR> +<TR><TD ALIGN="LEFT"><code>\pmname</code></TD> +<TD ALIGN="LEFT"><TT>pm</TT></TD> +</TR> +<TR><TD ALIGN="LEFT"><code>\amorpmname</code></TD> +<TD ALIGN="LEFT"><code>\amname</code> if morning, otherwise +<code>\pmname</code></TD> +</TR> +<TR><TD ALIGN="LEFT"><code>\amstring</code></TD> +<TD ALIGN="LEFT"><TT>in the morning</TT></TD> +</TR> +<TR><TD ALIGN="LEFT"><code>\pmstring</code></TD> +<TD ALIGN="LEFT"><TT>in the afternoon</TT></TD> +</TR> +<TR><TD ALIGN="LEFT"><code>\amorpmstring</code></TD> +<TD ALIGN="LEFT"><code>\amstring</code> if morning, otherwise +<code>\pmstring</code></TD> +</TR> +<TR><TD ALIGN="LEFT"><code>\halfpast</code></TD> +<TD ALIGN="LEFT"><TT>Half past</TT></TD> +</TR> +<TR><TD ALIGN="LEFT"><code>\quarterpast</code></TD> +<TD ALIGN="LEFT"><TT>Quarter past</TT></TD> +</TR> +<TR><TD ALIGN="LEFT"><code>\quarterto</code></TD> +<TD ALIGN="LEFT"><TT>Quarter to</TT></TD> +</TR> +<TR><TD ALIGN="LEFT"><code>\noon</code></TD> +<TD ALIGN="LEFT"><TT>Noon</TT></TD> +</TR> +<TR><TD ALIGN="LEFT"><code>\midnight</code></TD> +<TD ALIGN="LEFT"><TT>Midnight</TT></TD> +</TR> +<TR><TD ALIGN="LEFT"><code>\oclockstring</code></TD> +<TD ALIGN="LEFT"><TT>O'Clock</TT></TD> +</TR> +</TABLE> + +<P> + +<H1><A NAME="SECTION00090000000000000000"> +Package Options</A> +</H1> + +<P> +The following options may be passed to this package: +<BR> +<BR> <TABLE CELLPADDING=3> +<TR><TD ALIGN="LEFT"><TT></TD><TD ALIGN="LEFT">long </TT></TD> +<TD ALIGN="LEFT">make <code>\today</code> produce long date</TD> +</TR> +<TR><TD ALIGN="LEFT"><TT></TD><TD ALIGN="LEFT">short </TT></TD> +<TD ALIGN="LEFT">make <code>\today</code> produce short date</TD> +</TR> +<TR><TD ALIGN="LEFT"><TT></TD><TD ALIGN="LEFT">ddmmyyyy </TT></TD> +<TD ALIGN="LEFT">make <code>\today</code> produce DD/MM/YYYY date</TD> +</TR> +<TR><TD ALIGN="LEFT"><TT></TD><TD ALIGN="LEFT">dmyyyy </TT></TD> +<TD ALIGN="LEFT">make <code>\today</code> produce D/M/YYYY date</TD> +</TR> +<TR><TD ALIGN="LEFT"><TT></TD><TD ALIGN="LEFT">ddmmyy </TT></TD> +<TD ALIGN="LEFT">make <code>\today</code> produce DD/MM/YY date</TD> +</TR> +<TR><TD ALIGN="LEFT"><TT></TD><TD ALIGN="LEFT">dmyy </TT></TD> +<TD ALIGN="LEFT">make <code>\today</code> produce D/M/YY date</TD> +</TR> +<TR><TD ALIGN="LEFT"><TT></TD><TD ALIGN="LEFT">text </TT></TD> +<TD ALIGN="LEFT">make <code>\today</code> produce text date</TD> +</TR> +<TR><TD ALIGN="LEFT"><TT></TD><TD ALIGN="LEFT">us </TT></TD> +<TD ALIGN="LEFT">make <code>\today</code> produce US style date</TD> +</TR> +<TR><TD ALIGN="LEFT"><TT></TD><TD ALIGN="LEFT">mmddyyyy </TT></TD> +<TD ALIGN="LEFT">make <code>\today</code> produce MM/DD/YYYY date</TD> +</TR> +<TR><TD ALIGN="LEFT"><TT></TD><TD ALIGN="LEFT">mdyyyy </TT></TD> +<TD ALIGN="LEFT">make <code>\today</code> produce M/D/YYYY date</TD> +</TR> +<TR><TD ALIGN="LEFT"><TT></TD><TD ALIGN="LEFT">mmddyy </TT></TD> +<TD ALIGN="LEFT">make <code>\today</code> produce MM/DD/YY date</TD> +</TR> +<TR><TD ALIGN="LEFT"><TT></TD><TD ALIGN="LEFT">mdyy </TT></TD> +<TD ALIGN="LEFT">make <code>\today</code> produce M/D/YY date</TD> +</TR> +<TR><TD ALIGN="LEFT"><TT></TD><TD ALIGN="LEFT">raise </TT></TD> +<TD ALIGN="LEFT">make ordinal st,nd,rd,th appear as superscript</TD> +</TR> +<TR><TD ALIGN="LEFT"><TT></TD><TD ALIGN="LEFT">level </TT></TD> +<TD ALIGN="LEFT">make ordinal st,nd,rd,th appear level with rest of +text</TD> +</TR> +<TR><TD ALIGN="LEFT"><TT></TD><TD ALIGN="LEFT">dayofweek </TT></TD> +<TD ALIGN="LEFT">make the day of week appear for <code>\longdate</code>, +<code>\shortdate</code></TD> +</TR> +<TR><TD ALIGN="LEFT"><TT></TD><TD ALIGN="LEFT"></TT></TD> +<TD ALIGN="LEFT">or <code>\textdate</code></TD> +</TR> +<TR><TD ALIGN="LEFT"><TT></TD><TD ALIGN="LEFT">nodayofweek </TT></TD> +<TD ALIGN="LEFT">don't display the day of week.</TD> +</TR> +<TR><TD ALIGN="LEFT"><TT></TD><TD ALIGN="LEFT">24hr </TT></TD> +<TD ALIGN="LEFT">make <code>\currenttime</code> produce <TT>xxivtime</TT> +format</TD> +</TR> +<TR><TD ALIGN="LEFT"><TT></TD><TD ALIGN="LEFT">12hr </TT></TD> +<TD ALIGN="LEFT">make <code>\currenttime</code> produce <TT>ampmtime</TT> +format</TD> +</TR> +<TR><TD ALIGN="LEFT"><TT></TD><TD ALIGN="LEFT">oclock </TT></TD> +<TD ALIGN="LEFT">make <code>\currenttime</code> produce <TT>oclock</TT> +format</TD> +</TR> +<TR><TD ALIGN="LEFT"><TT></TD><TD ALIGN="LEFT">nodate </TT></TD> +<TD ALIGN="LEFT">Don't redefine <code>\today</code> or define the month or +day of week commands</TD> +</TR> +<TR><TD ALIGN="LEFT"><TT></TD><TD ALIGN="LEFT"></TT></TD> +<TD ALIGN="LEFT">(useful if you only want the time commands or +<code>\pdfdate</code>)</TD> +</TR> +</TABLE> + +<P> +The default options are: <TT>long</TT>, <TT>raise</TT>, +<TT>dayofweek</TT> and <TT>24hr</TT>. + +<P> + +<H1><A NAME="SECTION000100000000000000000"> +Multilingual Support</A> +</H1> + +<P> +If the <TT>babel</TT> package is called prior to +<TT>datetime</TT>, <code>\date</code><I>lang</I> +will be the default date format, +where <I>lang</I> is the current language. + +<P> +The commands <code>\monthname</code> and <code>\shortmonthname</code>, +will produce the month name in the current language. +If you want the month name in a specific language, you +can use the command <code>\monthname</code><I>lang</I>. +For example, <code>\monthnamefrench[6]</code> will produce the output: +juin. + +<P> +There is currently only limited multilingual support for +<code>\dayofweekname</code> and <code>\shortdayofweekname</code> (just +English, French, Portuguese and Spanish). You can add support for +other languages by defining the commands +<code>\dayofweeknameid</code><I>lang</I> and +<code>\shortdayofweeknameid</code><I>lang</I>. Note that these +commands only take <I>one</I> argument which should be +a number from 1 to 7 indicating the day of the week. + +<P> +You can use the following as templates. Replace +<TT>english</TT> with the name of your language (as given +by <code>\languagename</code>) and replace <TT>Sunday</TT> +etc as appropriate: +<PRE> +\providecommand{\dayofweeknameidenglish}[1]{% +\ifcase#1\relax +\or Sunday% +\or Monday% +\or Tuesday% +\or Wednesday% +\or Thursday% +\or Friday% +\or Saturday% +\fi} + +\providecommand{\shortdayofweekidnameenglish}[1]{% +\ifcase#1\relax +\or Sun% +\or Mon% +\or Tue% +\or Wed% +\or Thu% +\or Fri% +\or Sat% +\fi} +</PRE> +If you want them added to future versions of +<TT>datetime</TT>, please e-mail me the code. + +<P> + +<H1><A NAME="SECTION000110000000000000000"> +Configuration File</A> +</H1> + +<P> +As from Version 2.4, the <TT>datetime</TT> package will read in +settings from the configuration + file <TT>datetime.cfg</TT>, if it exists, which will override +the default package options. + For example, suppose you prefer a short date without the day of +week by default, you will need to create + a file called <TT>datetime.cfg</TT> that contains the line: +<PRE> +\shortdate\showdowfalse +</PRE> +The file <TT>datetime.cfg</TT> should then go somewhere on the +TeX path. Now all you need to do is: +<PRE> +\usepackage{datetime} +</PRE> +without having to specify the <TT>short</TT> and +<TT>nodayofweek</TT> options. + +<P> +You can also use this file to define and set your own date +styles. For example, you could create +a configuration file that has the following lines: +<PRE> +\newdateformat{dashdate}{\twodigit{\THEDAY}-\twodigit{\THEMONTH}-\THEYEAR} +\dashdate +</PRE> +Whenever you use the <TT>datetime</TT> package, it will now +use this format by default. + +<P> + +<H1><A NAME="SECTION000120000000000000000"> +LaTeX2HTML styles</A> +</H1> + +<P> +Version 2.43 and above of the <TT>datetime</TT> bundle +supplies the LaTeX2HTML style file <TT>datetime.perl</TT>. +This file should be placed in a +directory searched by LaTeX2HTML. The following limitations +apply to the LaTeX2HTML styles: + +<P> + +<UL> +<LI>The configuration file <TT>datetime.cfg</TT> +is currently ignored. (This is because +I can't work out the correct code to do this. If you +know how to do this, please let me know.) You can however +do: +<PRE> +\usepackage{datetime} +\html{\input{datetime.cfg}} +</PRE> +This, I agree, is an unpleasant cludge. + +<P> +</LI> +<LI>The commands <code>\monthname</code><I>language</I> are not +implemented. + +<P> +</LI> +<LI>Some of the languages are not implemented. + +<P> +</LI> +<LI>The package option <TT>nodate</TT> is not implemented. + +<P> +</LI> +</UL> + +<P> + +<H1><A NAME="SECTION000130000000000000000"> +Contact Details</A> +</H1> + Dr Nicola Talbot +<BR> +School of Computing Sciences +<BR> +University of East Anglia +<BR> +Norwich. NR4 7TJ. +<BR> +United Kingdom. +<BR> <TT><A NAME="tex2html12" + HREF="http://theoval.cmp.uea.ac.uk/~nlct/">http://theoval.cmp.uea.ac.uk/~nlct/</A></TT> +<BR><HR><H4>Footnotes</H4> +<DL> +<DT><A NAME="foot371">... format</A><A + HREF="manual.html#tex2html4"><SUP>1</SUP></A></DT> +<DD>Note that the commands <TT>\xxivtime</TT>, +<TT>\ampmtime</TT> and + <TT>\oclock</TT> are still available, +<TT>\settimeformat</TT> + redefines <TT>\currenttime</TT> to the command +given by placing a backslash in front of <I>style</I>. So + <TT>\settimeformat{xxivtime}</TT> sets +<TT>\currenttime</TT> + to <TT>\xxivtime</TT> and so on. + +</DD> +<DT><A NAME="foot131">... afternoon.</A><A + HREF="manual.html#tex2html5"><SUP>2</SUP></A></DT> +<DD>Version +2.43 fixed bug which caused an infinite loop on the hour. + +</DD> +<DT><A NAME="foot169">... <code>\pdfdate</code></A><A + HREF="manual.html#tex2html6"><SUP>3</SUP></A></DT> +<DD>thanks to Ulrich Dirr for +asking about this + +</DD> +<DT><A NAME="foot373">...year<code>}</code></A><A + HREF="manual.html#tex2html8"><SUP>4</SUP></A></DT> +<DD>Note the + name change since version 1.1. The command name was changed +from <TT>\thedate</TT> + to <TT>\formatdate</TT> + to avoid a name clash when using the <TT>seminar</TT> class +file. + +</DD> +<DT><A NAME="foot374">... +<code>\today</code></A><A + HREF="manual.html#tex2html9"><SUP>5</SUP></A></DT> +<DD>To be more precise, \ +<TT>today</TT> is defined to be \ +<TT>formatdate{\day}{\month}{\year}</TT> + where \<TT>longdate</TT> etc change the definition +of \<TT>formatdate</TT> + +</DD> +<DT><A NAME="foot233">...num<code>}</code></A><A + HREF="manual.html#tex2html10"><SUP>6</SUP></A></DT> +<DD>New to version 2.2 + +</DD> +<DT><A NAME="foot266">... command:</A><A + HREF="manual.html#tex2html11"><SUP>7</SUP></A></DT> +<DD>Thanks to Denis Bitouzé for asking about this + +</DD> +</DL> +<BR><HR> +<ADDRESS> +<a href=http://theoval.cmp.uea.ac.uk/~nlct/>Nicola L. C. Talbot</a>. <a href=http://www.cmp.uea.ac.uk/>School of Computing Sciences</a>. <a href=http://www.uea.ac.uk/>University of East Anglia.</a> Last Modified: 2005-10-01 +</ADDRESS> +</BODY> +</HTML> |