{{Module rating }}
Usage
{{#invoke:Calendar widget|calendar}}
Script error: The function "calendar" does not exist.
Parameters
Calendar parameters
|year=– specifies the year to be used when creating a monthly or yearly calendar; Gregorian calendar only; minimum 1583 for yearly calendar; minimum October 1582 for stand-alone month calendar; when omitted or out of range, uses current year|month=– specifies the month to be used when creating an stand-alone month calendar in the year specified by|year=; accepts a variety values:- numbers
1to12– defaults to current month when month number is out of range - month names (
January,March, etc) – defaults to current month when month name is not recognized - keywords:
current– display the current monthlast– display the month that occurs before the current monthnext– display the month that occurs after the current month
- numbers
|cols=– yearly calendars only; number of columnsnto be used for calendar rendering; default is4; values ofnless than 1 or greater than 12 ignored|iso=– accepts the single valueyes; calendar renders in ISO week format (Monday through Sunday); not needed if|iso_wk=set|iso_wk=– accepts the single valueyes; calendar renders in ISO week format (Monday through Sunday) with ISO week number in the left column; setting|iso_wk=yesautomatically sets|iso=yes
Styling parameters
|float=– position the rendered calendar; default position is at the left page margin:center– middle of the pageright– at the right page margin
|hide_year=– accepts the single valueyes; suppresses display of year in calendar headers; alias|show_year=off|show_today=– accepts the single valueyes; highlights the current date in the current-month calendar|today_color=– set the highlight color used by|show-today=; alias:|today_colour=|title_color=– set background color for the month title bar; overrides|color=; alias:|title_colour=|week_color=– set background color for the day-abbreviations title bar; overrides|color=; alias:|week_colour=|color=– shorthand for both|title_color=and|week_color=;|color=yields to|title_color=and|week_color=; alias:|colour=|wknum_color=– set background color for ISO week numbers; alias:|wknum_colour=
Linking parameters
|lk=– various date component linking options:d– link days in calendar to calendar day of calendar month –[[August 27]]m– link month in calendar header to month article –[[August]] 2019y– link year in calendar header to year article –August [[2025]]dm– link to days and monthdy– link to days and yearmy– link to month and yearyes– individually link all date componentsm&y– stand-alone month calendars only; link month and year together as a single composite link –[[August 2025]]dm&y– stand-alone month calendars only; link to days and composite month/year
Link prefixes and suffixes
These parameters require |lk=:
|lk_pref=– prefix for all day, month, and year links enabled by|lk=; yields to specific|lk_pref_x=parameters|lk_suff=– suffix for all day, month, and year links enabled by|lk=; yields to specific|lk_suff_x=parameters
These parameters automatically set |lk= to the appropriate value; override values assigned to |lk_pref= and |lk_suff=:
|lk_pref_d=– prefix for day links|lk_pref_m=– prefix for month and composite month/year links|lk_pref_y=– prefix for year links|lk_suff_d=– suffix for day links|lk_suff_m=– suffix for month links and composite month/year links|lk_suff_y=– suffix for year links
For stand-alone month calendars only, links to previous- and next-month targets:
|prevnext=– accepts the single valueyes; adds generic << and >> links to month header linked to the preceding and next month articles; automatically set if any of the following parameters are set:|lk_pref_mprev=– prefix for previous-month link|lk_suff_mprev=– suffix for previous-month link|lk_pref_mnext=– prefix for next-month link|lk_suff_mnext=– suffix for next-month link
Examples
if the current page and section is [[An example page#May]] and there is a May calendar there, to offer links to the previous month (April) and next month (June) sections set:
|k_pref_mprev=#– creates link to[[An example page#April]]|k_pref_mnext=#– creates link to[[An example page#June]]
if the current page is a subpage [[An example page/May]] and there is a May calendar there, to offer links to the previous month and next month subpages set:
|k_pref_mprev=../– creates link to[[An example page/April]]|k_pref_mnext=../– creates link to[[An example page/June]]- in
../,..is the parent ([[An example page]]) and/is the required path separator; see Uniform Resource Identifier
- in
--[[
Module to create Calendar widget
--]]
local p = {}
local function isleap(year)
year = tonumber(year) or 1
return year % 4 == 0
and year % 100 ~= 0
or year % 1000 == 0
end
--[[
isleap returns "leap" if passed a leap year
otherwise returns nothing
]]
function p.isleap(frame)
if isleap(frame.args[1]) then return "leap" end
return nil
end
return p