Template:Date-calc

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

Usage

The `Date-calc` template performs date arithmetic (addition or subtraction) using days, weeks, and months. It is useful for calculating dates relative to a given date.

Parameters

• date – The starting date in any valid format recognizable by the `#time` parser function (e.g., `1 April 2024`, `11 December 2025`).

Required

• operation – Specifies whether to add or subtract time. Valid values are:

 * add
 * subtract

• days – The number of days to add or subtract. Defaults to 0 if not provided.
• weeks – The number of weeks to add or subtract. Defaults to 0 if not provided.
• months – The number of months to add or subtract. Defaults to 0 if not provided.

Output

The template outputs the resulting date in the format DD Month YYYY (e.g., 15 January 2024).

Examples

Adding Time

• To add 2 months and 10 days to 1 January 2024:

 
  {{Date-calc|date=1 January 2024|operation=add|months=2|days=10}}
  
 Output: 11 March 2024

• To add 3 weeks to today's date:

 
  {{Date-calc|date={{TODAY}}|operation=add|weeks=3}}
  
 Output: (depends on today's date)

Subtracting Time

• To subtract 1 month and 2 weeks from 17 December 2024:

 
  {{Date-calc|date=17 December 2024|operation=subtract|months=1|weeks=2}}
  
 Output: 3 November 2024

• To subtract 15 days from 15 March 2024:

 
  {{Date-calc|date=15 March 2024|operation=subtract|days=15}}
  
 Output: 29 February 2024

Error Handling

If required parameters are missing:

 
  {{Date-calc|date=|operation=add}}
  
 Output: Please specify a valid date and operation (add or subtract).

Notes

• The template uses the `#time` parser function, which supports various date formats.
• The `days`, `weeks`, and `months` parameters can be used together or separately.
• If all time parameters (days, weeks, and months) are omitted, no calculation is performed, and the input date is returned as-is.

The above documentation is transcluded from Template:Date-calc/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.

Please specify a valid date and operation (add or subtract).