 | This is a documentation subpage for Template:Format time. It may contain usage information, categories and other content that is not part of the original template page. |
Syntax
[edit]((Format time|hour|minute|second))((Format time|hour|minute|second|TimeZone|hour_format=(format)))
Parameters
[edit](({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
[edit]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
[edit]- ((Format date)) for dates, with times optional
Multiple units of time
[edit]| 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
[edit]| 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:
[edit]Month:
((Lmonth)) produces Jul
((Nmonth)) produces Sep
((LastMonth)) produces July 2024
((NextMonth)) produces September 2024
Individual templates
[edit]- ((Calendar))
- ((Calendar clock with Wikipedia stats))
- ((Clock))
- ((Digital clock))
- ((Digital clock and date))
Categories of templates
[edit]- 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
[edit]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 |