Template:Calendar

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

This template displays either a yearly or monthly calendar (from 1970–2037).

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.

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

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.

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 documentation for this template used by VisualEditor and other tools.

Calendar

Display a year or month calendar

Template parameters[Edit template data]

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

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.

See also

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}}
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	{{Dow}}	{{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 Apr
{{Nmonth}} produces Jun
{{LastMonth}} produces April 2024
{{NextMonth}} produces June 2024

---

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

The above documentation is transcluded from Template:Calendar/doc. (edit | history)
Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages.
Add categories to the /doc subpage. Subpages of this template.