Template:ISOCALENDAR: Difference between revisions

Browse history interactively

← Previous edit Next edit →

Content deleted Content added

VisualWikitext

Inline

Revision as of 09:15, 4 June 2012

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

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

Parameters

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

Title

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

Month

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

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

Displaying the current month

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

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

Displaying a given month of the current year

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
Wk	Mo	Tu	We	Th	Fr	Sa	Su
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
Wk	Mo	Tu	We	Th	Fr	Sa	Su
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

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
Wk	Mo	Tu	We	Th	Fr	Sa	Su
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
Wk	Mo	Tu	We	Th	Fr	Sa	Su
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
Wk	Mo	Tu	We	Th	Fr	Sa	Su
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

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
Wk	Mo	Tu	We	Th	Fr	Sa	Su
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
Wk	Mo	Tu	We	Th	Fr	Sa	Su
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
Wk	Mo	Tu	We	Th	Fr	Sa	Su
W09	01	02	03	04	05	06	07
W10	08	09	10	11	12	13	14
W11	15	16	17	18	19	20	21
W12	22	23	24	25	26	27	28
W13	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
Wk	Mo	Tu	We	Th	Fr	Sa	Su
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

{{ISOCALENDAR|s=14}} gives

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

Sub-templates

The main Template:ISOCALENDAR calls

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

@@ Line 1: / Line 1: @@
 <includeonly>{| align="right" class="toccolours" style="margin-left: 1em; text-align:center; clear:right"
 |- style="background:lightblue;"
-|colspan="8"|'''{{{1}}}'''
+|colspan="8"|'''{{#if:{{{1|}}}
+   |{{{1}}}
+   |{{#time:F Y|{{#if:{{{m|}}}|{{{y|{{#time:Y}}}}}-{{{m}}}}}}}
+}}'''
 |-
 | width="{{{s|10}}}%"|[[ISO week date|Wk]]
@@ Line 12: / Line 15: @@
 | width="{{{s|10}}}%"|Su</font>
 |-
+{{ISOCALENDAR/month
-{{{{{subst|}}}ISOCALENDAR/1|subst={{{subst|}}}|w={{{{{subst|}}}#time:W|{{{{{subst|}}}trim|{{{y}}}}}-{{{{{subst|}}}trim|{{{m}}}}}-1}}|y={{{{{subst|}}}ISOYEAR|subst={{{subst|}}}|{{{y}}}|{{{m}}}|1}}|cw={{{cw|{{CURRENTWEEK}}}}}|cdow={{{cdow|{{CURRENTDOW}}}}}}}
+  |cw={{padleft:{{{cw|}}}|2}}
-|-
+  |cd={{#iferror:{{#expr:{{{cdow|}}}}}|{{#time:N|{{{cdow|}}}}}|{{{cdow|0}}}}}
-{{{{{subst|}}}ISOCALENDAR/1|subst={{{subst|}}}|w={{{{{subst|}}}#time:W|{{{{{subst|}}}trim|{{{y}}}}}-{{{{{subst|}}}trim|{{{m}}}}}-1 +1 week}}|y={{{{{subst|}}}ISOYEAR|subst={{{subst|}}}|{{{y}}}|{{{m}}}|8}}|cw={{{cw|{{CURRENTWEEK}}}}}|cdow={{{cdow|{{CURRENTDOW}}}}}}}
+  |fywd={{#time:o-"W"W-1
-|-
+     |{{#if:{{{m|}}}
-{{{{{subst|}}}ISOCALENDAR/1|subst={{{subst|}}}|w={{{{{subst|}}}#time:W|{{{{{subst|}}}trim|{{{y}}}}}-{{{{{subst|}}}trim|{{{m}}}}}-1 +2 weeks}}|y={{{{{subst|}}}ISOYEAR|subst={{{subst|}}}|{{{y}}}|{{{m}}}|15}}|cw={{{cw|{{CURRENTWEEK}}}}}|cdow={{{cdow|{{CURRENTDOW}}}}}}}
+        |{{{y|{{#time:Y}}}}}-{{{m}}}-01
-|-
+        |{{#iferror:{{#time:|{{{1}}}}}
-{{{{{subst|}}}ISOCALENDAR/1|subst={{{subst|}}}|w={{{{{subst|}}}#time:W|{{{{{subst|}}}trim|{{{y}}}}}-{{{{{subst|}}}trim|{{{m}}}}}-1 +3 weeks}}|y={{{{{subst|}}}ISOYEAR|subst={{{subst|}}}|{{{y}}}|{{{m}}}|22}}|cw={{{cw|{{CURRENTWEEK}}}}}|cdow={{{cdow|{{CURRENTDOW}}}}}}}<!--
+           |{{#time:Y-m-01}}
-th row -->
+           |{{#time:Y-m-01|{{{1}}}}}
-{{{{{subst|}}}#ifexpr:{{{{{subst|}}}ISOWEEKDATE2M|subst={{{subst|}}}|{{{{{subst|}}}ISOYEAR|subst={{{subst|}}}|{{{y}}}|{{{m}}}|29}}|{{{{{subst|}}}#expr:{{{{{subst|}}}#time:W|{{{{{subst|}}}trim|{{{y}}}}}-{{{{{subst|}}}trim|{{{m}}}}}-1 +3 weeks}}+1}}|1}}={{{m}}}|
+         }}
-{{!}}-
+      }}
-{{{{{subst|}}}ISOCALENDAR/1|subst={{{subst|}}}|w={{{{{subst|}}}#time:W|{{{{{subst|}}}trim|{{{y}}}}}-{{{{{subst|}}}trim|{{{m}}}}}-1 +4 weeks}}|y={{{{{subst|}}}ISOYEAR|subst={{{subst|}}}|{{{y}}}|{{{m}}}|29}}|cw={{{cw|{{CURRENTWEEK}}}}}|cdow={{{cdow|{{CURRENTDOW}}}}}}}<!--
+   }}
-th row -->
+}}
-{{{{{subst|}}}#ifexpr:{{{{{subst|}}}ISOWEEKDATE2M|subst={{{subst|}}}|{{{{{subst|}}}ISOYEAR|subst={{{subst|}}}|{{{y}}}|{{{m}}}|36}}|{{{{{subst|}}}#expr:{{{{{subst|}}}#time:W|{{{{{subst|}}}trim|{{{y}}}}}-{{{{{subst|}}}trim|{{{m}}}}}-1 +3 weeks}}+2}}|1}}={{{m}}}|
+|}</includeonly><noinclude>
-{{!}}-
-{{{{{subst|}}}ISOCALENDAR/1|subst={{{subst|}}}|w={{{{{subst|}}}#time:W|{{{{{subst|}}}trim|{{{y}}}}}-{{{{{subst|}}}trim|{{{m}}}}}-1 +5 weeks}}|y={{{{{subst|}}}ISOYEAR|subst={{{subst|}}}|{{{y}}}|{{{m}}}|36}}|cw={{{cw|{{CURRENTWEEK}}}}}|cdow={{{cdow|{{CURRENTDOW}}}}}}}}}}}
-|}
-</includeonly><noinclude>
 {{documentation}}
 </noinclude>