Template:Format time/sandbox
 | __EXPECTUNUSEDTEMPLATE__This is the template sandbox page for Template:Format time (diff). See also the companion subpage for test cases. |
Syntax
{{Format time|hour|minute|second}}{{Format time|hour|minute|second|TimeZone|hour_format=(format)}}
Parameters
{{{hour}}}is required, and is the hour in 24 hour format.- aliases:
{{{hh}}}and{{{1}}}(the first positional parameter)
- aliases:
{{{minute}}}is recommended; it is the minute after the hour (default 0).- aliases:
{{{mm}}}and{{{2}}}(the second positional parameter)
- aliases:
{{{second}}}is optional; seconds will only be rendered if this is not blank.- aliases:
{{{ss}}},{{{sec}}}and{{{3}}}(the third positional parameter)
- aliases:
{{{TimeZone}}}may be a numerical value, or "Z" for UTC; see examples.- aliases:
{{{timezone}}},{{{tz}}}and{{{4}}}(the fourth positional parameter)
- aliases:
{{{hour_format}}}can be blank, 'h', 'H', 'g' or 'G'; see §§ Hour format and below.
Examples:
{{Format time|08|30}}returns "08:30"{{Format time|08|30|23}}returns "08:30:23"{{Format time|08|30|tz=Z}}returns "08:30 (UTC)"{{Format time|08|30|23|timezone=+01:00}}returns "08:30:23 (+01:00)"{{Format time|08|30|23|TimeZone=-07:00}}returns "08:30:23 (-07:00)"
Hour format
The hour format parameter {{{hour_format}}} can be variously 'g', 'G', 'h', or 'H', specifying whether to use 12 hour time with AM/PM (g/h) or 24 hour time (G/H), and whether to truncate (g/G) numbers under 10 or not (h/H).
Examples:
{{Format time|08|30|hour_format=g}}returns "8:30 am"{{Format time|17|15|hour_format=g}}returns "5:15 pm"
{{Format time|08|30|hour_format=h}}returns "08:30 AM"{{Format time|17|15|hour_format=h}}returns "05:15 PM"
{{Format time|08|30|hour_format=G}}returns "8:30"{{Format time|17|15|hour_format=G}}returns "17:15"
{{Format time|08|30|hour_format=H}}returns "08:30"{{Format time|17|15|hour_format=H}}returns "17:15"
See also
- {{Format date}} for dates, with times optional
Multiple units of time
| Type | Adjustable | Current | Last | Next |
|---|---|---|---|---|
| Date and time | {{time}} | {{Currentdate}} (MDY) {{Plain now}} (DMY) {{Now}} (DMY in a complete sentence) {{Simple now}} |
||
| Date only | {{Dateonly}} {{Datedow}} (Has the day of the week) |
{{Date}} (Chose format) {{DATE}} (prefixed by date=) {{TODAY}} (DMY) |
{{Yesterday}} {{Day-1}} |
{{Tomorrow}} {{Day+1}} |
| Month and year only | {{Monthyear}} | {{Monthyear-1}} | {{Monthyear+1}} | |
| Time only | {{Timeonly}} | {{CURRENTTIME}} (12 h format) {{CURRENTTIME24}} (24 h format) |
||
| Banners | {{Right now}} (Blue with time and number of Wikipedia articles) |
|||
| Timestamp | {{Timestamp}} (Format YYYYMMDDhhmmss) |
Single units of time
| Unit of time | Adjustable | Current | Last | Next |
|---|---|---|---|---|
| SECOND | {{CURRENTSECOND}} | |||
| MINUTE | {{CURRENTMINUTE}} | |||
| HOUR | {{CURRENTHOUR}} | |||
| WEEK | {{CURRENTWEEK}} {{CURRENTWEEKOFMONTH}} |
|||
| Day of Week | {{DAYOFWEEK}} | {{CURRENTDAYNAME}} {{CURRENTWEEKDAYABBREV}} {{CURRENTWEEKDAY}} |
||
| MONTH | {{MONTHNAME}} {{MONTHABBREV}} {{MONTHNUMBER}} {{MONTH}} (zero padded) |
{{CURRENTMONTHNAME}} {{CURRENTMONTHABBREV}} {{CURRENTMONTH1}} {{CURRENTMONTHDAYS}} |
{{LASTMONTHNAME}} | {{NEXTMONTHNAME}} |
| Day of Month | {{CURRENTDAY}} {{CURRENTDAY2}} (zero padded) |
|||
| YEAR | {{CURRENTYEARCC}} {{CURRENTYEARYY}} {{CURRENTISOYEAR}} {{CURRENTYEAR}} |
{{LASTYEAR}} | {{NEXTYEAR}} | |
| Day of Year | {{CURRENTDAYOFYEAR}} | |||
| DECADE | {{DECADE}} | {{CURRENTDECADE}} | ||
| CENTURY | {{CENTURY}} | {{CURRENTCENTURY}} | ||
| MILLENNIUM | {{MILLENNIUM}} |
Date and time templates made for substitution:
Month:
{{Lmonth}} produces May
{{Nmonth}} produces Jul
{{LastMonth}} produces May 2025
{{NextMonth}} produces July 2025
Individual templates
- {{Calendar}}
- {{Calendar clock with Wikipedia stats}}
- {{Clock}}
- {{Digital clock}}
- {{Digital clock and date}}
Categories of templates
- Category:Time, date and calendar templates
- Category:Date-computing templates
- Category:Date-computing templates based on current time
- Category:ISO date templates
- Category:Calendar templates
Template Data
This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Format time in articles based on its TemplateData.
TemplateData for Format time
Formats a time of day
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| Hour | hour hh 1 | Hour of the day, in 24 hour format
| Number | required |
| Minute | minute mm 2 | minutes after the hour
| Number | suggested |
| Second | second ss sec 3 | Seconds after the minute | Number | optional |
| Hour format | hour_format | Formats hours and whether to render AM/PM or a.m./p.m.
| String | suggested |
| timezone | timezone tz TimeZone 4 | A numerical offset from UTC, or 'Z'. If non-empty, shows time zone
| String | optional |