Template:Calendar/doc

This is a documentation subpage for Template:Calendar.
It may contain usage information, categories and other content that is not part of the original template page.

This template is used on approximately 2,500 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

This template uses TemplateStyles:

Template:Calendar/styles.css^[e]

This template displays either a yearly or monthly calendar (from 1970–2037). If you need a feature that isn't on this template, consider {{ISOCALENDAR}}, or maybe Module:Calendar widget.

Parameters

month: To display a single month the parameter month must be defined. This parameter can be a month name or number, the current month use month=current (next and last are also accepted).

year: The parameter year sets the year of the calendar the default being the current year.

format: To start the week on Monday use either format=Mon1st or, to include ISO week numbers, format=iso. The keywords are case-sensitive.

Wk	Mo	Tu	We	Th	Fr	Sa	Su
	July
27			1	2	3	4	5
28	6	7	8	9	10	11	12
29	13	14	15	16	17	18	19
30	20	21	22	23	24	25	26
31	27	28	29	30	31
2026

show_year: To display the year use show_year=on. To show the year after the month use show_year=with month.

txt_pref_m: This adds a prefix to the month name.

txt_suff_m: This adds a suffix to the month name.

float: To float the calendar left or right use float=left or float=right.

lk: To link days, months and years use lk=on.; To link days and months use lk=dm.; To link months and years use lk=my.; To link days and years use lk=dy.; To link days only use lk=d.; To link months only use lk=m.; To link years only use lk=y.

lk_pref: This adds a prefix to all links.

lk_pref_d: This adds a prefix to day links.

lk_pref_m: This adds a prefix to month links.

lk_pref_mnext: This adds a prefix to the next month's link.

lk_pref_mprev: This adds a prefix to the previous month's link.

lk_suff: This adds a suffix to all links.

lk_suff_d: This adds a suffix to day links.

lk_suff_m: This adds a suffix to month links.

lk_suff_mnext: This adds a suffix to the next month's link.

lk_suff_mprev: This adds a suffix to the previous month's link.

prevnext: To add links to the previous and next months use prevnext=on.

title_colour: Use this to change the background colour of the title bar with name of the month, and the bottom bar (e.g. title_colour=#2e8b57).

week_colour: Use this to change the colour of the bar listing the days of the week (e.g. week_colour=#2e8b57).

colour: This is shorthand for both of the above.

fc: This is for the text colour.

wknum_colour: Use this to change the background colour of the ISO week numbers, when using format=iso (e.g. wknum_colour=#2e8b57).

wk5253: Use wk5253=on to start the year with week 52/53, when using format=iso with a year calendar. The only use case for this, is when the year is unknown and it starts with a Saturday. See Common year starting on Saturday as an example.

EndNote: This adds text to the bottom bar.

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Calendar in articles based on its TemplateData.

TemplateData for Calendar

Display a year or month calendar

Template parameters
Parameter		Description	Type	Status
Year	`year`	the ordinal year number of the calendar Default current	Number	suggested
Month	`month`	whether to display a single month instead of a whole year, and which one Default empty Example current, next, last, 1, January	String	suggested
Show year	`show_year`	whether to display the year number, and where Default on Example with month, off	Boolean	optional
Title text	`title`	text in the top bar	Content	optional
End note	`EndNote`	text in the bottom bar	Content	optional
Week format	`format`	The string to be trimmed and counted Default Sun1st Example iso, Mon1st	String	optional
Months per row	`col`	Display this many months per row (1, 3, 4 or 6 rows) Default 4 Example 2, 3, 12	Number	optional
Months per column	`row`	Display this many months per column (3 or 4 cols). If set, overrides ‘col’ parameter. Default empty Example 3, 4	Number	optional
Float side	`float`	Horizontally align the calendar Default none Example right, left	String	optional
Serial navigation	`prevnext`	Add links to the previous and next months Example on	Boolean	optional
Background color	`colour`	Default for Title and Week background Example #2E8B57	String	optional
Title background	`title_colour`	change the background colour of the title bar with name of the month, and the bottom bar Example #2E8B57	String	optional
Week background	`week_colour`	change the colour of the bar listing the days of the week Example #2E8B57	String	optional
ISO week numbers background	`wknum_colour`	change the colour of the bar listing the ISO week numbers Example #2E8B57	String	optional
Fixed starting week workaround	`wk5253`	start the year with week 52/53, when the first day is a Saturday.	Boolean	optional
Month name prefix	`txt_pref_m`	Text to add before month names	Line	optional
Month name suffix	`txt_suff_m`	Text to add after month names	Line	optional
Link	`lk`	whether to automatically link days (d), months (m) and years (y) Default off Example on = dmy, dm, my, dy, d, m, y	String	optional
Link prefix	`lk_pref`	Text to add before all links	Line	optional
Link suffix	`lk_suff`	Text to add after all links	Line	optional
Day link prefix	`lk_pref_d`	Text to add before links to days	Line	optional
Day link suffix	`lk_suff_d`	Text to add after links to days	Line	optional
Month link prefix	`lk_pref_m`	Text to add before links to months	Line	optional
Month link suffix	`lk_suff_m`	Text to add after links to months	Line	optional
Next link prefix	`lk_pref_mnext`	Text to add before the link to the next month (or year)	Line	optional
Next link suffix	`lk_suff_mnext`	Text to add after the link to the next month (or year)	Line	optional
Previous link prefix	`lk_pref_mprev`	Text to add before the link to the previous month (or year)	Line	optional
Previous link suffix	`lk_suff_mprev`	Text to add after the link to the next month (or year)	Line	optional
Text colour	`fc`	Adds the colour of the text Suggested values `inherit` Example inherit	String	optional

Examples

{{calendar|lk=on|show_year=on|float=right|month=current}} produces the calendar above. The calendars below are produced by {{calendar}} and {{calendar|prevnext=true|format=iso|zero=0|row=3}}, respectively.

2026

Wk	Mo	Tu	We	Th	Fr	Sa	Su
	January
01				01	02	03	04
02	05	06	07	08	09	10	11
03	12	13	14	15	16	17	18
04	19	20	21	22	23	24	25
05	26	27	28	29	30	31

Wk	Mo	Tu	We	Th	Fr	Sa	Su
	February
05							01
06	02	03	04	05	06	07	08
07	09	10	11	12	13	14	15
08	16	17	18	19	20	21	22
09	23	24	25	26	27	28

Wk	Mo	Tu	We	Th	Fr	Sa	Su
	March
09							01
10	02	03	04	05	06	07	08
11	09	10	11	12	13	14	15
12	16	17	18	19	20	21	22
13	23	24	25	26	27	28	29
14	30	31

Wk	Mo	Tu	We	Th	Fr	Sa	Su
	April
14			01	02	03	04	05
15	06	07	08	09	10	11	12
16	13	14	15	16	17	18	19
17	20	21	22	23	24	25	26
18	27	28	29	30

Wk	Mo	Tu	We	Th	Fr	Sa	Su
	May
18					01	02	03
19	04	05	06	07	08	09	10
20	11	12	13	14	15	16	17
21	18	19	20	21	22	23	24
22	25	26	27	28	29	30	31

Wk	Mo	Tu	We	Th	Fr	Sa	Su
	June
23	01	02	03	04	05	06	07
24	08	09	10	11	12	13	14
25	15	16	17	18	19	20	21
26	22	23	24	25	26	27	28
27	29	30

Wk	Mo	Tu	We	Th	Fr	Sa	Su
	July
27			01	02	03	04	05
28	06	07	08	09	10	11	12
29	13	14	15	16	17	18	19
30	20	21	22	23	24	25	26
31	27	28	29	30	31

Wk	Mo	Tu	We	Th	Fr	Sa	Su
	August
31						01	02
32	03	04	05	06	07	08	09
33	10	11	12	13	14	15	16
34	17	18	19	20	21	22	23
35	24	25	26	27	28	29	30
36	31

Wk	Mo	Tu	We	Th	Fr	Sa	Su
	September
36		01	02	03	04	05	06
37	07	08	09	10	11	12	13
38	14	15	16	17	18	19	20
39	21	22	23	24	25	26	27
40	28	29	30

Wk	Mo	Tu	We	Th	Fr	Sa	Su
	October
40				01	02	03	04
41	05	06	07	08	09	10	11
42	12	13	14	15	16	17	18
43	19	20	21	22	23	24	25
44	26	27	28	29	30	31

Wk	Mo	Tu	We	Th	Fr	Sa	Su
	November
44							01
45	02	03	04	05	06	07	08
46	09	10	11	12	13	14	15
47	16	17	18	19	20	21	22
48	23	24	25	26	27	28	29
49	30

Wk	Mo	Tu	We	Th	Fr	Sa	Su
	December
49		01	02	03	04	05	06
50	07	08	09	10	11	12	13
51	14	15	16	17	18	19	20
52	21	22	23	24	25	26	27
53	28	29	30	31

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}} {{Last month}}	{{Monthyear+1}} {{Next month}}
Time only	{{Timeonly}} (Adjustable to 12 h format)	{{CURRENTTIME}} (24 h format)
Banners		{{Right now}} (Blue with time and number of Wikipedia articles)
Timestamp		{{CURRENTTIMESTAMP}} (Format YYYYMMDDhhmmss)

Unit of time	Adjustable	Current	Last	Next
Second		{{CURRENTSECOND}}
Minute		{{CURRENTMINUTE}}
Hour		{{CURRENTHOUR}}
Week		{{CURRENTWEEK}} {{CURRENTWEEKOFMONTH}}
Day of Week	{{DAYOFWEEK}}	{{CURRENTDAYNAME}} {{CURRENTDAYNAMEABBREV}} {{CURRENTWEEKDAY}} (1–7, ISO) {{CURRENTDOW}} (0–6)
Month	{{MONTHNAME}} {{MONTHABBREV}} {{MONTHNUMBER}} {{MONTH}} (zero padded)	{{CURRENTMONTHNAME}} {{CURRENTMONTHABBREV}} {{CURRENTMONTH1}} {{CURRENTMONTHDAYS}}	{{LASTMONTHNAME}} {{Last month (short)}}	{{NEXTMONTHNAME}} {{Next month (short)}}
Day of Month		{{CURRENTDAY}} {{CURRENTDAY2}} (zero padded)
Year		{{CURRENTYEAR}} {{CURRENTYEARCC}} {{CURRENTYEARYY}} {{CURRENTISOYEAR}}	{{LASTYEAR}}	{{NEXTYEAR}}
Day of Year		{{CURRENTDAYOFYEAR}}
Decade	{{DECADE}}	{{CURRENTDECADE}}
Century	{{Century}}	{{CURRENTCENTURY}}
Millenium	{{MILLENNIUM}}

This page was redesigned at the edge.

A page that knows where it met you.

Template:Calendar/doc

Parameters

Examples

See also

Multiple units of time

Single units of time

Date and time templates made for substitution

Parser functions

Individual templates

Categories of templates