Command/date

\date

Syntax (autogenerated)

\date[...=...,...][...,...]
d	number
m	number
y	number
[...,...]	year year:name y y:name yy Y Y:name YY month month:mnem month:hebrew month:jalali m m:mnem m:hebrew m:jalali MONTH MONTH:mnem MONTH:hebrew MONTH:jalali mm M day day:name day:+ day:ord day:++ day:highord d d:name d:+ d:ord d:++ d:highord dd dd:+ dd:ord dd:++ dd:highord D D:+ D:ord D:++ D:highord weekday weekday:mnem weekday:hebrew weekday:jalali w w:mnem w:hebrew w:jalali WEEKDAY WEEKDAY:mnem WEEKDAY:hebrew WEEKDAY:jalali W referral space \\\\\\\\␣ text hebrew:to jalali:to jalali:from

\date[...=...,...][...]
d	number
m	number
y	number
[...]	name

Syntax

\date[...,...=...,...][...,...,...]
d	number
m	number
y	number
[...,...,...]

Description

Display a date. First optional argument specifies the date using the day (d), month (m) and year (y). If omitted the current date is assumed.

The second optional argument specifies the output format. Available fields are:

day, day:ord [preferred] or day:+ (to get st, nd, rd, th, depends on language), month, year, weekday, dd, dd:ord/dd:+, mm, yy, jj, d, d:ord/d:+, m, y, j, referral.

You can also insert delimiters between the fields (e.g. commas, spaces, see examples).

Example

\date \par
\date[d=25,m=4,y=2008] \par 
\date[d=25,m=4,y=2008][dd,--,mm,--,yy] \par
\date[d=25,m=4,y=2008][weekday,month,day,{,~},year] \par

To get a short month use \monthshort (lowercase, 25 apr 2008) or \MONTHSHORT (uppercase, 25 APR 2008) as follows:

\date[d=25,m=4,y=2008][day,~,month:mnem,~,year] \par
\date[d=25,m=4,y=2008][day,~,MONTH:mnem,~,year]

It is possible to redefine the \monthshort form to have a starting capital (e.g. 25 Apr 2008). Put the following in your environment file:

\setuplabeltext
  [en]
  [  january:mnem=Jan,
    february:mnem=Feb,
       march:mnem=Mar,
       april:mnem=Apr,
         may:mnem=May,
        june:mnem=Jun,
        july:mnem=Jul,
      august:mnem=Aug,
   september:mnem=Sep,
     october:mnem=Oct,
    november:mnem=Nov,
    december:mnem=Dec]

To get a short weekday use weekday:mnem (lowercase, fri 25 April 2008) as follows:

\date[d=25,m=4,y=2008][weekday:mnem,~,day,~,month,~,year] \par

It is possible to redefine the weekday:mnem form to have a starting capital (e.g. Fri 25 April 2008). Put the following in your environment file:

\setuplabeltext
  [en]
  [   monday:mnem=Mon,
     tuesday:mnem=Tue,
   wednesday:mnem=Wed,
    thursday:mnem=Thu,
      friday:mnem=Fri,
    saturday:mnem=Sat,
      sunday:mnem=Sun]

To change the formatting of the date in a global fashion the command \setuplanguage is used. A change to ISO 8601 for instance can be achieved as follows:

\setuplanguage [en] [date={year, –, mm, –, dd}]

For non english the setuplanguage command should be followed or preceded by setting a mainlanguage or it will not show up.

\setuplanguage [nl] [date={dd, –, mm, –, year}]
\mainlanguage [nl]

See also

• \currenttime
• \currentdate

Help from ConTeXt-Mailinglist/Forum

All issues with:

• date on the mailing list (all results)
• date on the mailing list (subject only)
• date on stack exchange
• date in ConTeXt's source