Template:Canadian dollar
CA$
Template documentation[view] [edit] [history] [purge] Relevant discussion at | → Template talk:Currency#Suggestions for a standard set of options for each template |
This is a multifunction template. At its simplest, it adds the currency mark "CA$", as recommended by MOS:CURRENCY for many situations. The template can also link to the Canadian dollar article and can even calculate inflation. See warnings below.
Usage
{{CAD|number}}
Additional text like "million" or "trillion" must be placed outside the template, typically preceded by a non-breaking space (see example below).
Example:
{{CAD}}→ CA${{CAD|123.45}}→ CA$123.45{{CAD|123}}{{nbsp}}million→ CA$123 million
Link
The parameter |link=yes may be used to link CA$ to the article Canadian dollar. This is turned off by default, but may be appropriate for the first occurrence of the term in an article.
Example:
{{CAD|123.45|link=yes}}→ CA$123.45
Inflation calculation
The template supports inflation calculation, by way of {{Inflation}}. If the second parameter is used, to specify a year, and this year is within a certain range of available inflation data (specifically, if 1688 ≤ year < 2023), the equivalent value represented in 2023 dollars will be calculated in parentheses. However, this function should only be used in appropriate situations.
Examples:
{{CAD|100|1687}}→ CA$100{{CAD|100|1688}}→ CA$100 (equivalent to $3,928 in 2023){{CAD|100|1966}}→ CA$100 (equivalent to $897.71 in 2023){{CAD|100|1966|link=yes}}→ CA$100 (equivalent to $897.71 in 2023){{CAD|100|2022}}→ CA$100 (equivalent to $103.9 in 2023){{CAD|100|2023}}→ CA$100{{CAD|100|2025}}→ CA$100{{CAD|100|2026}}→ CA$100
Additional parameter |about=yes will cause the template to calculate to the nearest dollar (instead of the nearest cent), and prefix the calculated value with "about". The rounding can be fine-tuned further by using |round=integer. These parameters may be combined.
Examples:
{{CAD|10|1935}}→ CA$10 (equivalent to $215.21 in 2023){{CAD|10|1935|round=0}}→ CA$10 (equivalent to $215 in 2023){{CAD|10|1935|about=yes}}→ CA$10 (equivalent to about $215 in 2023){{CAD|1000|1935|round=2}}→ CA$1,000 (equivalent to $21,520.55 in 2023){{CAD|1000|1935|round=-2}}→ CA$1,000 (equivalent to $21,500 in 2023){{CAD|1000|1935|round=-2|about=yes}}→ CA$1,000 (equivalent to about $21,500 in 2023)