Richardpruen: 1 revision imported

2022-01-02T17:21:58Z

1 revision imported

← Older revision		Revision as of 18:21, 2 January 2022
(No difference)

Wikipedia>John of Reading: Reverted 1 edit by 1.46.65.221 (talk): Rv duplication of content

2021-03-22T08:01:00Z

Reverted 1 edit by 1.46.65.221 (talk): Rv duplication of content

New page

{{Wikipedia how-to|H:TF}}
The '''time function''', or '''#time''', is the [[MediaWiki]] [[wp:parser function|parser function]] to display a date/time in other formats. For example ({{purge}} to update):

::* <kbd>{{#time:j F Y}} {{in5|14}} shows:{{nbsp}}{{#time:j F Y}}, the current [[UTC]] date</kbd>
::* <kbd>{{#time:F j, Y}} {{in5|13}} shows:{{nbsp}}{{#time:F j, Y}}, the current date in mdy format</kbd>
::* <kbd>{{#time:Y-m-d}} {{in5|14}} shows:{{nbsp}}{{#time:Y-m-d}}, current [[ISO 8601]] date</kbd>
::* <kbd>{{#time:H:i:s}} {{in5|14}} shows:{{nbsp}}{{#time:H:i:s}}, current time-of-day</kbd>
::* <kbd>{{#time:l}} {{in5|18}} shows{{nbsp|2}}"{{#time:l}}" as current day of week</kbd>
::* <kbd>{{#time:\d\a\y D}} {{in5|11}} shows{{nbsp|2}}"{{#time:\d\a\y D}}" as current 3-letter day</kbd>
::* <kbd>{{#time:j. F Y|7 May 2013|de}} {{in5|00}} shows{{nbsp|2}}"{{#time:j. F Y|7 May 2013|de}}" as a date in German</kbd>
::* <kbd>{{#time:xij xiF xiY}} {{in5|08}} shows{{nbsp|2}}"{{#time:xij xiF xiY}}" as current date in [[Iranian calendar]]</kbd>

There are over 35 date format codes (see below: [[#Time format codes|Time format codes]]) to rearrange the day-month-year, or hour-minute-second (such as 'j' for day, 'H' for hour, or el 'l' to show day-of-week). Other letters are treated as literal text, or use backslash to escape the format (<code>'\d'</code> shows 'd'). Parameter 2 can designate some other date/time (in any of several typical formats), while a 2-letter language code can be specified as parameter 3 to translate a month name into another language.

Beyond the [[Gregorian calendar]], the #time function can also convert a date into some other [[calendar]]s by using x-codes (x_): Islamic (xm), [[Iranian calendar|Iranian]] (xi), [[Hebrew calendar|Hebrew]] (xj), [[Thai calendar|Thai]] (xk), [[Minguo calendar|Minguo]] (xo), or the [[Japanese calendar]] (xt). For example, to show the [[Islamic date]], as the month and year: {{#time:xmF xmY}} → [[{{#time:xmF}}]] {{#time:xmY}}.

The #time function can show numerals in some other number systems by using x-codes (x_), including: [[Hindi language|Hindi]] (xn or xN), [[Hebrew language|Hebrew]] (xh), and [[Roman numerals]] (xr). For example, to show the current time, H:i:s, in Roman numerals: {{#time:xrH:xri:xrs}} → {{#time:xrH:xri:xrs}}. See more examples below: [[#Time format codes|Time format codes]].

== General features ==
The #time parser function takes a date and/or time (in the [[Gregorian calendar]]) and formats it according to the syntax given. A date/time object can be specified; the default is the value of the [[Help:Magic words#Date & time|magic word]] <kbd><nowiki>{{CURRENTTIMESTAMP}}</nowiki></kbd> – that is, the time the page was last rendered into HTML.

: <kbd><nowiki>{{#time:</nowiki> ''format string'' <nowiki>}}</nowiki></kbd>
: <kbd><nowiki>{{#time:</nowiki> ''format string'' <nowiki>|</nowiki> ''date/time object'' <nowiki>}}</nowiki></kbd>
: <kbd><nowiki>{{#time:</nowiki> ''format string'' <nowiki>|</nowiki> ''date/time object'' <nowiki>|</nowiki> ''language code'' <nowiki>}}</nowiki></kbd>

The list of accepted formatting codes is given in the table [[#Time format codes|below]]. Any character in the formatting string that is not recognised is passed through unaltered; this applies also to blank spaces (the system does not need them for interpreting the codes). There are also two ways to escape characters within the formatting string:
# A backslash followed by a formatting character is interpreted as a single literal character
# Characters enclosed in double quotes are considered literal characters, and the quotes are removed.

In addition, the digraph <kbd>xx</kbd> is interpreted as a single literal "x".

: <kbd><nowiki>{{#time: Y-m-d }}</nowiki></kbd> → '''{{#time: Y-m-d }}'''
: <kbd><nowiki>{{#time: [[Y]] m d }}</nowiki></kbd> → '''{{#time: [[Y]] m d }}'''
: <kbd><nowiki>{{#time: [[Y (year)]] }}</nowiki></kbd> → '''{{#time: [[Y (year)]] }}'''
: <kbd><nowiki>{{#time: [[Y "(year)"]] }}</nowiki></kbd> → '''{{#time: [[Y "(year)"]] }}'''
: <kbd><nowiki>{{#time: i's" }}</nowiki></kbd> → '''{{#time: i's" }}'''

The <kbd>''date/time object''</kbd> can be in any format accepted by PHP's [http://www.php.net/manual/en/function.strtotime.php strtotime()] function. Both absolute (e.g., <kbd>20 December 2000</kbd>) and relative (e.g., <kbd>+20 hours</kbd>) times are accepted.

: <kbd><nowiki>{{#time: r|now}}</nowiki></kbd> → '''{{#time: r|now}}'''
: <kbd><nowiki>{{#time: r|+2 hours}}</nowiki></kbd> → '''{{#time: r|+2 hours}}'''
: <kbd><nowiki>{{#time: r|now + 2 hours}}</nowiki></kbd> → '''{{#time: r|now + 2 hours}}'''
: <kbd><nowiki>{{#time: r|20 December 2000}}</nowiki></kbd> → '''{{#time: r|20 December 2000}}'''
: <kbd><nowiki>{{#time: r|December 20, 2000}}</nowiki></kbd> → '''{{#time: r|December 20, 2000}}'''
: <kbd><nowiki>{{#time: r|2000-12-20}}</nowiki></kbd> → '''{{#time: r|2000-12-20}}'''
: <kbd><nowiki>{{#time: r|2000 December 20}}</nowiki></kbd> → '''{{#time: r|2000 December 20}}'''

The two-letter ''language code'' in [[w:en:ISO 639-1|ISO 639-1]] allows the string to be displayed in the chosen language.
: <kbd><nowiki>{{#time:d F Y|1988-02-28|nl}}</nowiki></kbd> → '''{{#time:d F Y|1988-02-28|nl}}'''
: <kbd><nowiki>{{#time:l|now|uk}}</nowiki></kbd> → '''{{#time:l|now|uk}}'''
: <kbd><nowiki>{{#time:d xg Y|20 June 2010|pl}}</nowiki></kbd> → '''{{#time:d xg Y|20 June 2010|pl}}'''

If you've calculated a Unix timestamp, you may use it in date calculations by pre-pending an <kbd>@</kbd> symbol.

: <kbd><nowiki>{{#time: U | now }}</nowiki></kbd> → '''{{#time: U | now}}'''
: <kbd><nowiki>{{#time: r|@</nowiki>{{#time: U}}<nowiki>}}</nowiki></kbd> → '''{{#time: r| @{{#time:U}} }}'''

{{warning|The range of acceptable input is 1 January 0111 → 31 December 9999. For the years 100 through 110 the output is inconsistent, Y and leap years are like the years 100-110, r, D, l and U are like interpreting these years as 2000-2010. 
<kbd><nowiki>{{#time: d F Y | 29 Feb 0100 }}</nowiki></kbd> → '''{{#time: d F Y | 29 Feb 0100 }}''' (correct, no leap year), but 
<kbd><nowiki>{{#time: r | 29 Feb 0100 }}</nowiki></kbd> → '''{{#time: r | 29 Feb 0100 }}''' (wrong, even if 100 is interpreted as 2000, because that is a leap year) 
<kbd><nowiki>{{#time: d F Y | 15 April 10000 }}</nowiki></kbd> → '''{{#time: d F Y | 15 April 10000 }}''' 
<kbd><nowiki>{{#time: r | 10000-4-15 }}</nowiki></kbd> → '''{{#time: r | 10000-4-15 }}'''

Year numbers 0-99 are interpreted as 2000-2069 and 1970-1999, even when written with leading zeros:
: <kbd><nowiki>{{#time: d F Y | 1 Jan 0069 }}</nowiki></kbd> → '''{{#time: d F Y | 1 Jan 0069 }}'''
: <kbd><nowiki>{{#time: d F Y | 1 Jan 0070 }}</nowiki></kbd> → '''{{#time: d F Y | 1 Jan 0070 }}'''

The weekday is supplied for the years 100-110 and from 1753, for the years 111-1752 the r-output shows "Unknown" and the l-output "<>". As a consequence, the r-output is not accepted as input for these years.}}

Full or partial absolute dates can be specified; the function will "fill in" parts of the date that are not specified using the ''current'' values:

: <kbd><nowiki>{{#time: Y | January 1 }}</nowiki></kbd> → '''{{#time: Y | January 1 }}'''

Many options are provided.

== Time format codes ==
The following table explains the 35 various codes for date/time formats, plus the codes for months in other languages, and the x-codes (x_) to convert to some other [[calendar]]s or number systems.
{| class="wikitable"  style="float:left; width:70%; font-size: 90%;  line-height: 1.25em; margin-left: 1em;"
! {{hl1}} | Code
! {{hl1}} | Description
! {{hl1}} | Current output ([{{fullurl:Help:Time function|action=purge}} Purge this page's cache] to update)
|-
! {{hl2}} colspan="3"| Year
|-
| style="text-align: center;" | <kbd>Y</kbd>
| 4-digit year.
| style="text-align: center;" | {{#time:Y}}
|-
| style="text-align: center;" | <kbd>y</kbd>
| 2-digit year.
| style="text-align: center;" | {{#time:y}}
|-
| style="text-align: center;" | <kbd>L</kbd>
| 1 if it's a leap year, 0 if not.
| style="text-align: center;" | {{#time:L}}
|-
| style="text-align: center;" | <kbd>o</kbd> ¹
| ISO-8601 year of the specified week. ²
| style="text-align: center;" | {{#time:o}} ³
|-
| colspan="3" style="font-size: 88%;" |
¹ Requires PHP 5.1.0 and newer and [[rev:45208]]. 
² This has the same value as Y, except that if the ISO week number (W) belongs to the previous or next year, that year is used instead. 
³ Will output literal ''o'' if ¹ not fulfilled.
|-
! {{hl2}} colspan="3"| Month
|-
| style="text-align: center;" | <kbd>n</kbd>
| Month index, not zero-padded.
| style="text-align: center;" | {{#time:n}}
|-
| style="text-align: center;" | <kbd>m</kbd>
| Month index, zero-padded.
| style="text-align: center;" | {{#time:m}}
|-
| style="text-align: center;" | <kbd>M</kbd>
| An abbreviation of the month name, in the site language.
| style="text-align: center;" | {{#time:M}}
|-
| style="text-align: center;" | <kbd>F</kbd>
| The full month name in the site language.
| style="text-align: center;" | {{#time:F}}
|-
| style="text-align: center;" | <kbd>xg</kbd>
| Output the full month name in the genitive form for site languages that distinguish between genitive and nominative forms.
| For Polish:

(nominative)

<kbd><nowiki>{{#time:d F Y|20 June 2010|pl}}</nowiki></kbd> → {{#time:d F Y|20 June 2010|pl}}

(genitive)

<kbd><nowiki>{{#time:d xg Y|20 June 2010|pl}}</nowiki></kbd> → {{#time:d xg Y|20 June 2010|pl}}
|-
! {{hl2}} colspan="3"| Week
|-
| style="text-align: center;" | <kbd>W</kbd>
| ISO 8601 week number, zero-padded.
| style="text-align: center;" | {{#time:W}}
|-
! {{hl2}} colspan="3"| Day
|-
| style="text-align: center;" | <kbd>j</kbd>
| Day of the month, not zero-padded.
| style="text-align: center;" | {{#time:j}}
|-
| style="text-align: center;" | <kbd>d</kbd>
| Day of the month, zero-padded.
| style="text-align: center;" | {{#time:d}}
|-
| style="text-align: center;" | <kbd>z</kbd>
| Day of the year (January 1 = 0).¹
| style="text-align: center;" | {{#time:z}}
|-
| style="text-align: center;" | <kbd>D</kbd>
| An abbreviation for the day of the week. Rarely internationalised.
| style="text-align: center;" | {{#time:D}}
|-
| style="text-align: center;" | <kbd>l</kbd>
| The full weekday name. Rarely internationalised.
| style="text-align: center;" | {{#time:l}}
|-
| style="text-align: center;" | <kbd>N</kbd>
| ISO 8601 day of the week (Monday = 1, Sunday = 7).
| style="text-align: center;" | {{#time:N}}
|-
| style="text-align: center;" | <kbd>w</kbd>
| Number of the day of the week (Sunday = 0, Saturday = 6).
| style="text-align: center;" | {{#time:w}}
|-
| colspan="3" style="font-size: 88%;" |
¹ To get the ISO day of the year add 1.
|-
! {{hl2}} colspan="3"| Hour
|-
| style="text-align: center;" | <kbd>a</kbd>
| "am" during the morning (00:00:00 → 11:59:59), "pm" otherwise (12:00:00 → 23:59:59).
| style="text-align: center;" | {{#time:a}}
|-
| style="text-align: center;" | <kbd>A</kbd>
| Uppercase version of <kbd>a</kbd> above.
| style="text-align: center;" | {{#time:A}}
|-
| style="text-align: center;" | <kbd>g</kbd>
| Hour in 12-hour format, not zero-padded.
| style="text-align: center;" | {{#time:g}}
|-
| style="text-align: center;" | <kbd>h</kbd>
| Hour in 12-hour format, zero-padded.
| style="text-align: center;" | {{#time:h}}
|-
| style="text-align: center;" | <kbd>G</kbd>
| Hour in 24-hour format, not zero-padded.
| style="text-align: center;" | {{#time:G}}
|-
| style="text-align: center;" | <kbd>H</kbd>
| Hour in 24-hour format, zero-padded.
| style="text-align: center;" | {{#time:H}}
|-
! {{hl2}} colspan="3"| Minutes and seconds
|-
| style="text-align: center;" | <kbd>i</kbd>
| Minutes past the hour, zero-padded.
| style="text-align: center;" | {{#time:i}}
|-
| style="text-align: center;" | <kbd>s</kbd>
| Seconds past the minute, zero-padded.
| style="text-align: center;" | {{#time:s}}
|-
| style="text-align: center;" | <kbd>U</kbd>
| Seconds since January 1 1970 00:00:00 GMT.
| style="text-align: center;" | {{#time:U}}
|-
! id="TimeZone" {{hl2}} colspan="3"| Timezone (as of [[MediaWiki_1.22/Roadmap|1.22wmf2]])
|-
| style="text-align: center;" | <kbd>e</kbd>
| Timezone identifier.
| style="text-align: center;" | {{#time:e}}
|-
| style="text-align: center;" | <kbd>I</kbd>
| Whether or not the date is in daylight savings time.
| style="text-align: center;" | {{#time:I}}
|-
| style="text-align: center;" | <kbd>O</kbd>
| Difference to Greenwich time (GMT)
| style="text-align: center;" | {{#time:O}}
|-
| style="text-align: center;" | <kbd>P</kbd>
| Difference to Greenwich time (GMT), with colon
| style="text-align: center;" | {{#time:P}}
|-
| style="text-align: center;" | <kbd>T</kbd>
| Timezone abbreviation.
| style="text-align: center;" | {{#time:T}}
|-
| style="text-align: center;" | <kbd>Z</kbd>
| Timezone offset in seconds.
| style="text-align: center;" | {{#time:Z}}
|-
! {{hl2}} colspan="3"| Miscellaneous
|-
| style="text-align: center;" | <kbd>t</kbd>
| Number of days in the current month.
| style="text-align: center;" | {{#time:t}}
|-
| style="text-align: center;" | <kbd>c</kbd>
| ISO 8601 formatted date, equivalent to <kbd><nowiki>Y-m-d"T"H:i:s+00:00</nowiki></kbd>.
| style="font-size: 75%;" | {{#time:c}}
|-
| style="text-align: center;" | <kbd>r</kbd>
| RFC 5322 formatted date, equivalent to <kbd><nowiki>D, j M Y H:i:s +0000</nowiki></kbd>, with weekday name and month name not internationalised.
| style="font-size: 75%;" | {{#time:r}}
|-
! {{hl2}} colspan="3" | Non-Gregorian calendars
|-
! {{hl3}} colspan="3" | Islamic
|-
| style="text-align: center;" | <kbd>xmj</kbd>
| Day of the month.
| {{#time:xmj}}
|-
| style="text-align: center;" | <kbd>xmF</kbd>
| Full month name.
| {{#time:xmF}}
|-
| style="text-align: center;" | <kbd>xmn</kbd>
| Month index.
| {{#time:xmn}}
|-
| style="text-align: center;" | <kbd>xmY</kbd>
| Full year.
| {{#time:xmY}}
|-
! {{hl3}} colspan="3" | Iranian (Jalaly)
|-
| style="text-align: center;" | <kbd>xij</kbd>
| Day of the month.
| {{#time:xij}}
|-
| style="text-align: center;" | <kbd>xiF</kbd>
| Full month name.
| {{#time:xiF}}
|-
| style="text-align: center;" | <kbd>xin</kbd>
| Month index.
| {{#time:xin}}
|-
| style="text-align: center;" | <kbd>xiY</kbd>
| Full year.
| {{#time:xiY}}
|-
| style="text-align: center;" | <kbd>xiy</kbd>
| 2-digit year.
| {{#time:xiy}}
|-
! {{hl3}} colspan="3" | Hebrew
|-
| style="text-align: center;" | <kbd>xjj</kbd>
| Day of the month.
| {{#time:xjj}}
|-
| style="text-align: center;" | <kbd>xjF</kbd>
| Full month name.
| {{#time:xjF}}
|-
| style="text-align: center;" | <kbd>xjt</kbd>
| Number of days in month.
| {{#time:xjt}}
|-
| style="text-align: center;" | <kbd>xjx</kbd>
| Genitive form of the month name.
| {{#time:xjx}}
|-
| style="text-align: center;" | <kbd>xjn</kbd>
| Month number.
| {{#time:xjn}}
|-
| style="text-align: center;" | <kbd>xjY</kbd>
| Full year.
| {{#time:xjY}}
|-
! {{hl3}} colspan="3" | Thai solar
|-
| style="text-align: center;" | <kbd>xkY</kbd>
| Full year.
| {{#time:xkY}}
|-
! {{hl3}} colspan="3" | Minguo/Juche year
|-
| style="text-align: center;" | <kbd>xoY</kbd>
| Full year.
| {{#time:xoY}}
|-
! {{hl3}} colspan="3" | Japanese nengo
|-
| style="text-align: center;" | <kbd>xtY</kbd>
| Full year.
| {{#time:xtY}}
|-
! {{hl2}} colspan="3" | Flags
|-
| style="text-align: center;" | <kbd>xn</kbd>
| Format the next numeric code as a raw ASCII number.
| In the Hindi language, <kbd><nowiki>{{#time:H, xnH}}</nowiki></kbd> produces ०६, 06.
|-
| style="text-align: center;" | <kbd>xN</kbd>
| colspan="2" | Like <kbd>xn</kbd>, but as a toggled flag, which endures until the end of the string or until the next appearance of <kbd>xN</kbd> in the string.
|-
| style="text-align: center;" | <kbd>xr</kbd>
| Format the next number as a Roman numeral. Only works for numbers up to 10,000 (up to 3,000 in pre MediaWiki 1.20).
| <kbd><nowiki>{{#time:xrY}}</nowiki></kbd> → {{#time:xrY}}
|-
| style="text-align: center;" | <kbd>xh</kbd>
| Format the next number as a Hebrew numeral.
| <kbd><nowiki>{{#time:xhY}}</nowiki></kbd> → {{#time:xhY}}
|}
{{clear}}

== See also ==
* [[Template:Time]], the current date/time
* [[Template:Now]], shows a sentence with the current date/time
* [[Template:TODAY]], shows only the current date, in typical dmy form
* [[Template:Today]], a navbox about the U.S. daily TV talk-show ''Today''
* [[mediawikiwiki:Help:Extension:ParserFunctions##time|mw:Help:Extension:ParserFunctions # #time]], developer's documentation page
* [[Unix time]]

{{Wikipedia technical help|collapsed}}
[[Category:Wikipedia how-to|Time Function]]

Help:Time function - Revision history

Richardpruen: 1 revision imported

Wikipedia>John of Reading: Reverted 1 edit by 1.46.65.221 (talk): Rv duplication of content