Category talk:Time, date and calendar templates
 | This category does not require a rating on Wikipedia's content assessment scale. It is of interest to the following WikiProjects: | ||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
Clean up
[edit]There's a lot of unused or hardly used templates here. Many templates have complicated code which could be replaced with much simpler code based on the #time parser function. JIMp talk·cont 08:33, 5 June 2012 (UTC)
ISO date templates
[edit]There used to be a tangle of ISO date templates one calling another until you hit one of the final ones with its huge algorithm. Using the #time parser function instead gives us a huge saving of code. Were they worth fixing? Note that {{date}} accepts ISO week date format input (as a single parameter) & could easily enough be adjusted to output it too but there's hardly any use for this as was evident by the almost complete disuse of these. They had been used to form the basis of {{ISOCALENDAR}} but that was rewritten using the #time parser function. After that rewrite there were very few instances where they were usefully employed. All of these uses have now been replaced with #time parser functions.
{{CURRENTWEEKDATE}} gave the current date in ISO week date format. The following could be used instead.
{{#time:o-"W"W-N}}
{{ISOWEEKDATE}}
{{CURRENTISODATE}} gave the current date in ISO format. The following could be used instead.
{{#time:Y-m-d}}
{{CURRENTYEAR}}-{{padleft:{{CURRENTMONTH}}|2|0}}-{{padleft:{{CURRENTDAY}}|2|0}}
{{CURRENTISOWEEK}} gave the current week in ISO week date format. The following could be used instead.
{{#time:W}}
{{ISOWEEK|{{CURRENTYEAR}}|{{CURRENTMONTH}}|{{CURRENTDAY}}}}
{{CURRENTISOWEEKDAY}} gave the current weekday number in ISO week date format. The following could be used instead.
{{#time:N}}
{{ISOWEEKDAY|{{CURRENTYEAR}}|{{CURRENTMONTH}}|{{CURRENTDAY}}}}
{{ISOWEEKDATE}} converted a from a year, month and day to ISO week date format. The year, month and day were entered separately and defaulted to their current values. The following would be equivalent.
{{#time:o-"W"W-N|{{#time:Y|{{{1|}}}}}-{{#time:m|{{{2|}}}}}-{{#time:d|{{{3|}}}}}}}
However, by entering the whole date as a single parameter we can make it easier to use (since there is only one parameter and also it doesn't have to be in YYYY-MM-DD format) and at the same time simplify the code.
{{#time:o-"W"W-N|{{{1|}}}}}
{{ISOYEAR|{{{1|{{CURRENTYEAR}}}}}|{{{2|{{CURRENTMONTH}}}}}|{{{3|{{CURRENTDAY}}}}}}}-W{{ISOWEEK|{{{1|{{CURRENTYEAR}}}}}|{{{2|{{CURRENTMONTH}}}}}|{{{3|{{CURRENTDAY}}}}}}}-{{ISOWEEKDAY|{{{1|{{CURRENTYEAR}}}}}|{{{2|{{CURRENTMONTH}}}}}|{{{3|{{CURRENTDAY}}}}}}}
{{ISOYEAR}} gave an ISO week date year for a given year, month and day. The year, month and day were required and entered separately. The following would be equivalent.
{{#if:{{{3|}}}|{{#if:{{{2|}}}|{{#if:{{{1|}}}|{{#time:o|{{{1}}}-{{{2}}}-{{{3}}}}}|Parameter 1=''year'' required!}}|Parameter 2=''month'' required!}}|Parameter 3=''day'' required !}}
Instead why not have a single-optional-parameter defaulting to the current time?
{{#time:o|{{{1|}}}}}
{{#if:{{{3|}}}|{{#if:{{{2|}}}|{{#if:{{{1|}}}|{{#switch:{{{2}}}|1={{#ifexpr:{{{3}}}<4-{{WEEKDAY|{{{1}}}|1|4}}|{{#expr:{{{1}}}-1}}|{{{1}}}}}|12={{#ifexpr:{{{3}}}>=35-{{WEEKDAY|{{{1}}}|12|35}}|{{#expr:{{{1}}}+1}}|{{{1}}}}}|{{{1}}}}}|Parameter 1=''year'' required!}}|Parameter 2=''month'' required!}}|Parameter 3=''day'' required !}}
{{ISOWEEK}} gave an ISO week date week for a given year, month and day. The year, month and day were required and entered separately. The following would be equivalent (except that you'd get a different error message for incorrect input & it accepts the month as a name or abbreviation).
{{#time:W|{{{1}}}-{{{2}}}-{{{3}}}}}
Instead why not have a single-optional-parameter defaulting to the current time again?
{{#time:W|{{{1|}}}}}
{{{{{subst|}}}#switch: {{{{{subst|}}}evalp|subst={{{subst|}}}|1=-({{{2}}}=1)*({{{3}}}<4-( ( 1.25* ({{{1}}}-1) -.4 round 0)+({{{1}}}>250)* (2 - ( ({{{1}}}-1) /100 -.495 round 0) +( ({{{1}}}-1) /400 -.499 round 0) ) + 700000001 ) mod 7)+({{{2}}}=12)*({{{3}}}>=35-( ( 1.25* {{{1}}} -.4 round 0)+({{{1}}}>250)* (2 - ( {{{1}}} /100 -.495 round 0) +( {{{1}}} /400 -.499 round 0) ) + 700000001 ) mod 7)
|2=isoyear minus Gregorian year in week}}|0={{{{{subst|}}}void|case 0}}{{{{{subst|}}}#ifexpr:10>{{{{{subst|}}}evalp|subst={{{subst|}}}|1=({{{{{subst|}}}#switch: {{{2}}}|1=0|2=31|3=59|4=90|5=120|6=151|7=181|8=212|9=243|10=273|11=304|12=334}}
+{{{3}}}
+({{{2}}}>2)* ((({{{1}}} mod 4 = 0) and ({{{1}}} mod 100 != 0)) or ({{{1}}} mod 400 = 0))+6-((( 700000005.2+2.6*({{{2}}}+12*({{{2}}}<3)))round 0)+{{{3}}} + ( 1.25* ({{{1}}}-({{{2}}}<3)) -.4 round 0)
+({{{1}}}>250)* (2 - ( ({{{1}}}-1) /100 -.495 round 0) +( ({{{1}}}-1) /400 -.499 round 0)) ) mod 7)/7 round 0|2=in week case 0}}|0}}{{{{{subst|}}}evalp|subst={{{subst|}}}|1=({{{{{subst|}}}#switch: {{{2}}}|1=0|2=31|3=59|4=90|5=120|6=151|7=181|8=212|9=243|10=273|11=304|12=334}}
+{{{3}}}
+({{{2}}}>2)* ((({{{1}}} mod 4 = 0) and ({{{1}}} mod 100 != 0)) or ({{{1}}} mod 400 = 0))+6-((( 700000005.2+2.6*({{{2}}}+12*({{{2}}}<3)))round 0)+{{{3}}} + ( 1.25* ({{{1}}}-({{{2}}}<3)) -.4 round 0)
+({{{1}}}>250)* (2 - ( ({{{1}}}-1) /100 -.495 round 0) +( ({{{1}}}-1) /400 -.499 round 0)) ) mod 7)/7 round 0|2=in week case 0}}
|-1={{{{{subst|}}}void|
case -1
}}{{{{{subst|}}}evalp|subst={{{subst|}}}|1=((365+{{{3}}}
+ (((({{{1}}}-1) mod 4 = 0) and (({{{1}}}-1)mod 100 != 0)) or ({{{1}}}-1) mod 400 = 0))+6-((( 700000005.2+2.6*({{{2}}}+12*({{{2}}}<3)))round 0)+{{{3}}} + ( 1.25* ({{{1}}}-({{{2}}}<3)) -.4 round 0)
+({{{1}}}>250)* (2 - ( ({{{1}}}-({{{2}}}<3)) /100 -.495 round 0) +( ({{{1}}}-({{{2}}}<3)) /400 -.499 round 0)) ) mod 7)/7 round 0|2=in week case -1}}
|1=01}}
{{ISOWEEKDAY}} gave an ISO week day number for a given year, month and day. The year was required but the day and month defaulted to the first and January. The following would be equivalent (except that you'd get a different error message for incorrect input & it accepts the month as a name or abbreviation).
{{#time:N|{{{1}}}-{{{2|1}}}-{{{3|1}}}}}
Again a single-optional-parameter defaulting to the current time might be better.
{{#time:N|{{{1|}}}}}
{{{{{subst|}}}evalp|
((((({{{1|}}})*12+({{{2|1}}})+57608.5 round 0)/12-1.5 round 0)*1461/4-0.5 round 0)
-(((({{{1|}}})*12+({{{2|1}}})+57608.5 round 0)/12-1.5 round 0)/100-0.5 round 0)
+(((({{{1|}}})*12+({{{2|1}}})+57608.5 round 0)/12-1.5 round 0)/400-0.5 round 0)
+(((({{{2|1}}})+57608.5 round 0)mod 12+4)*153/5-0.5 round 0)+({{{3|1}}})-32167
)mod7+1|in DOW|subst={{{subst|}}}}}
{{ISOWEEKDATE2YMD}} produced a date in ISO YYYY-MM-DD format for a given ISO-week-date year, week (a single digit was accepted) and weekday number which were each required and entered separately. You'd get the same from the following (assuming correct input).
{{#time:Y-m-d|{{{1}}}-W{{padleft:{{{2}}}|2}}-{{{3}}}}}
Again a single-optional-parameter version accepting the date in any format would be better.
{{#time:Y-m-d|{{{1|}}}}}
{{WEEKDATE2Y|{{{1}}}|{{{2}}}|{{{3}}}}}-{{ISOWEEKDATE2M|{{{1}}}|{{{2}}}|{{{3}}}}}-{{ISOWEEKDATE2D|{{{1}}}|{{{2}}}|{{{3}}}}}
{{ISOWEEKDATE2D}} produced a date of the month (with a leading zero if less than 10) for a given ISO-week-date year, week (a single digit was accepted) and weekday number which were each required and entered separately. You'd get the same from the following (assuming correct input).
{{#time:d|{{{1}}}-W{{padleft:{{{2}}}|2}}-{{{3}}}}}
Here's the single-optional-parameter version accepting the date in any format.
{{#time:d|{{{1|}}}}}
{{#ifexpr: {{WEEKDATE2D|{{{1}}}|{{{2}}}|{{{3}}}}} < 10 | 0}}{{WEEKDATE2D|{{{1}}}|{{{2}}}|{{{3}}}}}
{{ISOWEEKDATE2M}} produced a month number (with a leading zero if less then 10) for a given ISO-week-date year, week (a single digit was accepted) and weekday number which were each required and entered separately. You'd get the same from the following (assuming correct input).
{{#time:m|{{{1}}}-W{{padleft:{{{2}}}|2}}-{{{3}}}}}
Here's the single-optional-parameter version accepting the date in any format.
{{#time:m|{{{1|}}}}}
{{#ifexpr:{{WEEKDATE2M|{{{1}}}|{{{2}}}|{{{3}}}}} < 10 |0}}{{WEEKDATE2M|{{{1}}}|{{{2}}}|{{{3}}}}}
{{ISOWEEKDATE2Y}} produced a year for a given ISO-week-date year, week (a single digit was accepted) and weekday number which were each required and entered separately. You'd get the same from the following (assuming correct input).
{{#time:Y|{{{1}}}-W{{padleft:{{{2}}}|2}}-{{{3}}}}}
Here's the single-optional-parameter version accepting the date in any format.
{{#time:Y|{{{1|}}}}}
#REDIRECT [[Template:WEEKDATE2Y]]
{{WEEKDATE2Y}} gave the same as {{ISOWEEKDATE2Y}}.
{{{{{subst|}}}evalp|1= {{{1}}} + (((7*{{{2}}}+{{{3}}}-10+(700000006 - {{{1}}} - ((({{{1}}}-1)/4 -0.499) round 0) + ({{{1}}}>=250) * ( 5 + ((({{{1}}}-1)/100 -0.499) round 0) - (({{{1}}}-1)/400 -0.499) round 0)) mod 7-74.8- (((({{{1}}}) mod 4 = 0) and (({{{1}}}) mod 100 != 0)) or (({{{1}}}) mod 400 = 0)))/30.6 round 0)mod 12+3-{{#switch:{{evalp|1=7*{{{2}}}+{{{3}}}-10+(700000006 - {{{1}}} - ((({{{1}}}-1)/4 -0.499) round 0) + ({{{1}}}>=250) * ( 5 + ((({{{1}}}-1)/100 -0.499) round 0) - (({{{1}}}-1)/400 -0.499) round 0)) mod 7 + 1000 * (((({{{1}}}) mod 4 = 0) and (({{{1}}}) mod 100 != 0)) or (({{{1}}}) mod 400 = 0))|2=orddate in weekdate2m}}|-1|0|29|30|31|1000|1030|1031=1|0}} - 6.5 ) / 12 round 0|2=in weekdate2m}}
{{WEEKDATE2M}} gave the same as {{ISOWEEKDATE2M}} but without any leading zero. You'd get the same from the following (assuming correct input).
{{#time:n|{{{1}}}-W{{padleft:{{{2}}}|2}}-{{{3}}}}}
Here's the single-optional-parameter version accepting the date in any format.
{{#time:n|{{{1|}}}}}
{{{{{subst|}}}#switch:{{{{{subst|}}}#expr:((7*{{{2}}}+{{{3}}}-10+(700000006 - {{{1}}} - ((({{{1}}}-1)/4 -0.499) round 0) + ({{{1}}}>=250) * ( 5 + ((({{{1}}}-1)/100 -0.499) round 0) - (({{{1}}}-1)/400 -0.499) round 0)) mod 7-74.8- (((({{{1}}}) mod 4 = 0) and (({{{1}}}) mod 100 != 0)) or (({{{1}}}) mod 400 = 0)))/30.6 round 0)mod 12+3-{{{{{subst|}}}#switch:{{{{{subst|}}}#expr:7*{{{2}}}+{{{3}}}-10+(700000006 - {{{1}}} - ((({{{1}}}-1)/4 -0.499) round 0) + ({{{1}}}>=250) * ( 5 + ((({{{1}}}-1)/100 -0.499) round 0) - (({{{1}}}-1)/400 -0.499) round 0)) mod 7 + 1000 * (((({{{1}}}) mod 4 = 0) and (({{{1}}}) mod 100 != 0)) or (({{{1}}}) mod 400 = 0))}}|-1|0|29|30|31|1000|1030|1031=1|0}}}}|0=12|1=1|2=2|3=3|4=4|5=5|6=6|7=7|8=8|9=9|10=10|11=11|12=12|13=1}}
{{WEEKDATE2D}} gave the same as {{ISOWEEKDATE2D}} but without any leading zero. You'd get the same from the following (assuming correct input).
{{#time:j|{{{1}}}-W{{padleft:{{{2}}}|2}}-{{{3}}}}}
Here's the single-optional-parameter version accepting the date in any format.
{{#time:j|{{{1|}}}}}
{{{{{subst|}}}#expr:
10*
(7*{{{2}}}+{{{3}}}-10+
(700000006 - {{{1}}} -
((({{{1}}}-1
)/4 -0.499
) round 0
) +
({{{1}}}>=250
) *
( 5 +
((({{{1}}}-1
)/100 -0.499
) round 0
) -
(({{{1}}}-1
)/400 -0.499
) round 0
)) mod 7-59.5 +
{{{{{subst|}}}#ifexpr:7*{{{2}}}+{{{3}}}-10+
((700000006 - {{{1}}} -
((({{{1}}}-1
)/4 -0.499
) round 0
) +
({{{1}}}>=250
) *
( 5 +
((({{{1}}}-1
)/100 -0.499
) round 0
) -
(({{{1}}}-1
)/400 -0.499
) round 0
)) mod 7
)-59.5-
(((({{{1}}}
) mod 4 = 0
) and
(({{{1}}}
) mod 100 != 0
)) or
(({{{1}}}
) mod 400 = 0
)) <0
|365
|(-
(((({{{1}}}
) mod 4 = 0
) and
(({{{1}}}
) mod 100 != 0
)) or
(({{{1}}}
) mod 400 = 0
)))
}}
) mod 306
/10+0.5 round 0
}}
{{ISOdate}}
[edit]A particularly strange example was {{ISOdate}}. The doc pages consisted of "Please explain what this template does and how it can be used" in bold at the top and then a bunch of examples. There was no real explanation of what it's for. It was used about four or five times on WP where it did nothing but hide the month/day of dates in ISO format. JIMp talk·cont 08:33, 5 June 2012 (UTC)
- {{ISOdate|1909}}
- {{ISOdate|abcdef}}
- {{ISOdate|5 May 1909}}
- {{ISOdate|May 5, 1909}}
- {{ISOdate|1=A}}
- {{ISOdate|1=Y|1987}}
- {{ISOdate|1=Y|2=1987}}
- {{ISOdate|1=Y|1987|3=M|April}}
- {{ISOdate|one|two|three}}
- {{ISOdate|1=one|2=two|3=three}}
- {{ISOdate|1909-12-31}}
- {{ISOdate|1909-01-13}}
- {{ISOdate|1909-02-03}}
- {{ISOdate|1909-03-02}}
{{#ifexpr: ({{#ifeq: {{{1|}}} | | 1 | 0 }}) or ({{#iferror: {{#expr: {{{1}}} }} | 1 | 0 }}) or ({{#iferror: {{#time: Y | {{{1}}} }} | 1 | 0 }}) or (({{#iferror: {{#time: y | {{{1}}} }} | 32 | {{#time: y | {{{1}}} }} }} < 32) and (abs({{#iferror: {{#expr: {{#if: {{{1|}}} | {{{1}}} | 0 }} }} | 0 | {{#expr: {{#if: {{{1|}}} | {{{1}}} | 0 }} }} }}) < 98 ))
| {{{1|}}}
| {{#ifeq: {{#expr: {{{1}}} }} | {{{1}}}
| {{#ifeq: "{{#expr: {{{1}}} }}" | "{{{1}}}"
| {{date| {{{1}}} ||| {{{2|}}} }}
| {{{1}}}
}}
| {{#ifexpr: ({{#ifexpr: {{{1}}} = {{#time: d-m-Y | {{{1}}} }} | 1 | 0 }}) or ({{#ifexpr: {{{1}}} = {{#time: Y-m-d | {{{1}}} }} | 1 | 0 }})
| {{date| {{#time: Y | {{{1}}} }} | {{#ifeq: {{uc: {{{f|}}} }} | Y | |{{#time: n | {{{1}}} }}}} | {{#ifeq: {{uc: {{{f|}}} }} | Y | | {{#time: j | {{{1}}} }} }} | {{{2|}}} }}
| {{#ifexpr: abs({{#expr: {{{1}}} }}) < 100
| {{#ifexpr: {{#time: Y | {{{1}}} }} >= 2000
| {{date| {{#expr: {{#time: Y | {{{1}}} }} - 2000 }} | {{#ifeq: {{uc: {{{f|}}} }} | Y | |{{#time: n | {{{1}}} }}}} |{{#ifeq: {{uc: {{{f|}}} }} | Y | | {{#time: j | {{{1}}} }}}} | {{{2|}}} }}
| {{date| {{#expr: {{#time: Y | {{{1}}} }} - 1900 }} | {{#ifeq: {{uc: {{{f|}}} }} | Y | |{{#time: n | {{{1}}} }}}} |{{#ifeq: {{uc: {{{f|}}} }} | Y | | {{#time: j | {{{1}}} }}}} | {{{2|}}} }}
}}
| {{#ifexpr: ({{#ifexpr: {{{1}}} = {{#time: m-Y | {{{1}}} }} | 1 | 0 }}) or ({{#ifexpr: {{{1}}} = {{#time: Y-m | {{{1}}} }} | 1 | 0 }})
| {{date| {{#time: Y | {{{1}}} }} | {{#ifeq: {{uc: {{{f|}}} }} | Y ||{{#time: n | {{{1}}} }} }} || {{{2|}}} }}
| {{{1}}}
}}
}}
}}
}}
}}
{{Days left in monthX}}
[edit]Here's an interesting template. It calculated the number of days left in the month (including today). You had to tell it how many days there were in the month, though. Interestingly there was a suggestion put on the page to use {{CURRENTMONTHDAYS}} instead of {{{1}}} (why not actually do so?). If this suggestion had been implimented, then the template wouldn't have had to be adjusted each month. The main contributor to the template overcame the problem with
{{days left in monthX|{{#switch:{{CURRENTMONTHABBREV}}|Jan=31|Mar=31|May=31|Jul=31|Aug=31|Oct=31|Dec=31|Feb=28|Apr=30|Jun=30|Sep=30|Nov=30}}}}
instead in the only transclusion the template enjoyed outside of its own talk pages (pages this was actually originally two templates: {{days in month30}} and {{days in month31}} for months of 30 and 31 days respectively). Either way you get the number of days left in the current month (including today) which is what
{{#expr:{{#time:t-j+1}}}}
will give you. JIMp talk·cont 08:33, 5 June 2012 (UTC)
{{#switch:{{{1}}}
|leap={{#switch:{{CURRENTDAY}}
|1=29
|2=28
|3=27
|4=26
|5=25
|6=24
|7=23
|8=22
|9=21
|10=20
|11=19
|12=18
|13=17
|14=16
|15=15
|16=14
|17=13
|18=12
|19=11
|20=10
|21=9
|22=8
|23=7
|24=6
|25=5
|26=4
|27=3
|28=2
|29=1
}}
|28={{#switch:{{CURRENTDAY}}
|1=28
|2=27
|3=26
|4=25
|5=24
|6=23
|7=22
|8=21
|9=20
|10=19
|11=18
|12=17
|13=16
|14=15
|15=14
|16=13
|17=12
|18=11
|19=10
|20=9
|21=8
|22=7
|23=6
|24=5
|25=4
|26=3
|27=2
|28=1
}}
|31={{#switch:{{CURRENTDAY}}
|1=31
|2=30
|3=29
|4=28
|5=27
|6=26
|7=25
|8=24
|9=23
|10=22
|11=21
|12=20
|13=19
|14=18
|15=17
|16=16
|17=15
|18=14
|19=13
|20=12
|21=11
|22=10
|23=9
|24=8
|25=7
|26=6
|27=5
|28=4
|29=3
|30=2
|31=1
}}
|30={{#switch:{{CURRENTDAY}}
|1=30
|2=29
|3=28
|4=27
|5=26
|6=25
|7=24
|8=23
|9=22
|10=21
|11=20
|12=19
|13=18
|14=17
|15=16
|16=15
|17=14
|18=13
|19=12
|20=11
|21=10
|22=9
|23=8
|24=7
|25=6
|26=5
|27=4
|28=3
|29=2
|30=1
}}
|#default=''Number''}}
<noinclude>----
This template is a combo of what used to be ''Days left in month30'' and ''Days left in month31'', plus, a days left in a leap year, and days left in month28.Use the variable in the template to tell which set you want. leap=days left in leap year;31=days left in month31;30=Days left in month30;28=days left in a normal February.
Note :
Consider using [[Template:MONTHDAYS]] instead to get the number of days in specified year and month number, and just specify year instead of this ''strange'' first parameter, or use [[Template:CURRENTMONTHDAYS]] to get the number of days in current month.
[[Category:Date mathematics templates|{{PAGENAME}}]]
</noinclude>
{{Weekdays in month}}
[edit]This one was transcluded only on itself. It took three unnamed parameters the year, the month and the day of the week (as a number 0 for Sunday, 1 for Monday, etc.).
{{#ifexpr: {{#expr: 29 + ( 6 + {{{3}}} - {{WEEKDAY|{{{1}}}|{{{2}}}|1}} ) mod 7 }} > {{Days in month|{{{1}}}|{{{2}}}}}|4|5}}
It would be better to reverse the order: day of the week, month then year so that you could leave out the year and default to the current year or leave out the year and month and default to the current year and month. The template called two other templates but it could use #time instead. By using #time you could combine the year and month into one parameter (you could combine all three into one but that would not be that logical). You can also make it more user-friendly by allowing the day to be entered as a word or abbreviation instead of a number. This could be used instead (the first parameter is the weekday and the second the month/year):
{{#expr:4+(((7+{{#time:w|{{{1|}}}}}-{{#time:w|1 {{#time:M Y|{{{2|}}}}}}})mod7)<({{#time:t|{{{2|}}}}}-28))}}
... if ever we need to know the number of a given weekday there is in a month. JIMp talk·cont 09:24, 5 June 2012 (UTC)