Template:ISOCALENDAR/doc

From Wikipedia, the free encyclopedia

You might also want to check out Module:Calendar widget or Template:Calendar.

Parameters[edit]

1 title
y calendar year
m calendar month
s width in percent of each column of day (default is 10)
cw week number to highlight
cdow weekday to highlight
hideweek (optional) Suppresses display of week-number column if there's anything in this param

All parameters are optional.

  • m and cdow may be fully spelt out, abbreviated or numeric.
  • The numbering for cw and cdow is in accordance with ISO 8601 (ISO week date: Monday → 1, Tuesday → 2, ... Sunday → 7)

Output[edit]

Title[edit]

The calendar title is determined by 1 (the first unnamed parameter), the default is the month and year of the calendar displayed.

Month[edit]

The month of the calendar displayed is determined by m.

  • If m is specified, then the year can be specified with y, the default is the current year.
  • If m is not specified but 1 is a valid time the month and/or year is set to match the title, the default is the current month and/or year.

Highlighting[edit]

By default the current day is highlighted. To highlight (an)other day(s) use cw and cdow. cw gives the week and cdow the day of the week to be highlighted.

  • Together they determine a specific day to be highlighted.
  • cw alone will highlight the whole week.
  • cdow alone will highlight the given week day for the whole month.

Examples[edit]

Displaying the current month[edit]

To display the current month use {{ISOCALENDAR}}.

May 2024
Week Mon Tue Wed Thu Fri Sat Sun
W18 29 30 01 02 03 04 05
W19 06 07 08 09 10 11 12
W20 13 14 15 16 17 18 19
W21 20 21 22 23 24 25 26
W22 27 28 29 30 31 01 02

Displaying a given month of the current year[edit]

A given month of this year can be specified with 1. Alternatively, m can be used. Perhaps you want a different title e.g. {{ISOCALENDAR|This November|m=11|y=2006}}.

{{ISOCALENDAR|August}} {{ISOCALENDAR|m=Sep}}
August
Week Mon Tue Wed Thu Fri Sat Sun
W31 29 30 31 01 02 03 04
W32 05 06 07 08 09 10 11
W33 12 13 14 15 16 17 18
W34 19 20 21 22 23 24 25
W35 26 27 28 29 30 31 01
September 2024
Week Mon Tue Wed Thu Fri Sat Sun
W35 26 27 28 29 30 31 01
W36 02 03 04 05 06 07 08
W37 09 10 11 12 13 14 15
W38 16 17 18 19 20 21 22
W39 23 24 25 26 27 28 29
W40 30 01 02 03 04 05 06

Displaying a given month of a given year[edit]

A given month and year can be specified with 1 like this. Alternatively m and y can be used. Perhaps you want a different title e.g. "Quintilis".

{{ISOCALENDAR|May 2006}} {{ISOCALENDAR|m=June|y=2006}} {{ISOCALENDAR|Quintilis MMVI|m=5|y=2006}}
May 2006
Week Mon Tue Wed Thu Fri Sat Sun
W18 01 02 03 04 05 06 07
W19 08 09 10 11 12 13 14
W20 15 16 17 18 19 20 21
W21 22 23 24 25 26 27 28
W22 29 30 31 01 02 03 04
June 2006
Week Mon Tue Wed Thu Fri Sat Sun
W22 29 30 31 01 02 03 04
W23 05 06 07 08 09 10 11
W24 12 13 14 15 16 17 18
W25 19 20 21 22 23 24 25
W26 26 27 28 29 30 01 02
Quintilis MMVI
Week Mon Tue Wed Thu Fri Sat Sun
W18 01 02 03 04 05 06 07
W19 08 09 10 11 12 13 14
W20 15 16 17 18 19 20 21
W21 22 23 24 25 26 27 28
W22 29 30 31 01 02 03 04

Highlight a week, a day of the week, or a day, or a date, or hide display of the week column[edit]

You can highlight "Saturday of week 3 in January 2021", "all of week 6 in February 2021", or "all Thursdays of March 2021" like this:

{{ISOCALENDAR|January 2021|cw=3|cdow=Sat}} {{ISOCALENDAR|February 2021|cw=23}} {{ISOCALENDAR|March 2021|cdow=4|hideweek=yes}}
January 2021
Week Mon Tue Wed Thu Fri Sat Sun
W53 28 29 30 31 01 02 03
W01 04 05 06 07 08 09 10
W02 11 12 13 14 15 16 17
W03 18 19 20 21 22 23 24
W04 25 26 27 28 29 30 31
February 2021
Week Mon Tue Wed Thu Fri Sat Sun
W05 01 02 03 04 05 06 07
W06 08 09 10 11 12 13 14
W07 15 16 17 18 19 20 21
W08 22 23 24 25 26 27 28
March 2021
Mon Tue Wed Thu Fri Sat Sun
01 02 03 04 05 06 07
08 09 10 11 12 13 14
15 16 17 18 19 20 21
22 23 24 25 26 27 28
29 30 31 01 02 03 04

Highlighting a specific date based on a timestamp is somewhat more difficult, because you can't just pass the date into this template, you have to calculate the week number and day of week. Luckily, we have ParserFunctions that can parse all sorts of time data (in which there are even ready-made functions to get zero-padded ISO 8601 numbers: W for week and N for day-of-week). This can be done like so:

{{ISOCALENDAR
    |September 2001
    |cw   = {{#time: W|2001-09-11 12:46:40}}
    |cdow = {{#time: N|2001-09-11 12:46:40}}
}}
September 2001
Week Mon Tue Wed Thu Fri Sat Sun
W35 27 28 29 30 31 01 02
W36 03 04 05 06 07 08 09
W37 10 11 12 13 14 15 16
W38 17 18 19 20 21 22 23
W39 24 25 26 27 28 29 30

Single-line format looks like:

{{ISOCALENDAR|January 2001|cw={{#time: W|foo}}|cdow = {{#time: N|foo}}}}

Adjusting the width[edit]

{{ISOCALENDAR|s=14}} gives

May 2024
Week Mon Tue Wed Thu Fri Sat Sun
W18 29 30 01 02 03 04 05
W19 06 07 08 09 10 11 12
W20 13 14 15 16 17 18 19
W21 20 21 22 23 24 25 26
W22 27 28 29 30 31 01 02

Sub-templates[edit]

The main Template:ISOCALENDAR calls