Template:Format time/sandbox

This is the template sandbox page for Template:Format time (diff).
See also the companion subpage for test cases.

Template documentation[view] [edit] [history] [purge]

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)
{{{minute}}} is recommended; it is the minute after the hour (default 0).
- aliases: {{{mm}}} and {{{2}}} (the second positional parameter)
{{{second}}} is optional; seconds will only be rendered if this is not blank.
- aliases: {{{ss}}}, {{{sec}}} and {{{3}}} (the third positional parameter)
{{{TimeZone}}} may be a numerical value, or "Z" for UTC; see examples.
- aliases: {{{timezone}}}, {{{tz}}} and {{{4}}} (the fourth positional parameter)
{{{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"


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) {{TODAY}} (DMY)	{{Yesterday}} {{Day-1}}	{{Tomorrow}} {{Day+1}}
Month and year only		{{Monthyear}} {{DATE}} (prefixed by date=)	{{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 Jul
{{Nmonth}} produces Sep
{{Last month}} produces July 2025
{{Next month}} produces September 2025

Parser functions

mw:Special:MyLanguage/time permits a custom time specifier string, similar to the C date and time functions

Individual templates

Categories of 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

Template parameters[Edit template data]
Parameter		Description	Type	Status
Hour	`hour` `hh` `1`	Hour of the day, in 24 hour format Example 13 Auto value	Number	required
Minute	`minute` `mm` `2`	minutes after the hour Example 3 Auto value `0`	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. Example g (7:00 p.m.), G (07:00 PM), h (19:00), or H (19:00)	String	suggested
timezone	`timezone` `tz` `TimeZone` `4`	A numerical offset from UTC, or 'Z'. If non-empty, shows time zone Example Z	String	optional

The above documentation is transcluded from Template:Format time/doc.
Editors can experiment in this template's sandbox and testcases pages.
Add categories to the /doc subpage. Subpages of this template.