Template talk:Convert

view · edit Frequently asked questions Q: When using {{convert}} why does the answer sometimes seem a bit off? A: This template takes into account the precision of the supplied value and generally rounds the output to the same level of precision. If you need to change from the default output precision, see rounding. Note: This can cause whole numbers that end in one or more zeroes to be converted less accurately than expected. Q: What are all the possible units (kg, lb, m, cm, ft, in, °C, °F, km, mi, nmi, mph, km/h, and so on)? A: See Help:Convert units for an introduction and Module:Convert/documentation/conversion data for the complete list. Q: I've been using Convert for some time and am pretty comfortable with its basic features. Does it have other features which it would be worth my while to learn about? A: Almost certainly. Start with Help:Convert. For more, see the FAQ.

Template:Convert is permanently protected from editing because it is a heavily used or highly visible template. Substantial changes should first be proposed and discussed here on this page. If the proposal is uncontroversial or has been discussed and is supported by consensus, editors may use {{edit template-protected}} to notify an administrator or template editor to make the requested edit. Usually, any contributor may edit the template's documentation to add usage notes or categories. Any contributor may edit the template's sandbox. Functionality of the template can be checked using test cases.

Archives

Archive 1 Archive 2 Archive 3

This page has archives. Sections older than 42 days may be automatically archived by Lowercase sigmabot III when more than 2 sections are present.

Template:Convert

... in conception

... and in reality

At Transport in Switzerland#Railways I've found a need to convert 122 km/1000 km² into imperial (probably something like miles per 100 or 1000 sqmi). Is this something convert can handled? In the article I've gone with separate conversions to come up with 76 mi per 390 sq mi which is not ideal. Thryduulf (talk) 16:58, 19 July 2024 (UTC)[reply]

Best I can find is {{cvt|0.122|km/km2|mi/sqmi|3}} to display as 0.122 km/km² (0.196 mi/sq mi)

In theory we should be able to use e3km2 and e3sqmi but these don't work.  Stepho  talk  17:22, 19 July 2024 (UTC)[reply]

Similarly at List of prominent mountains of Switzerland#Distribution there is approximately 1.09 summits per 100 km² that I've just left as I can't work out anything sensible (I don't think 0.0109/km² (0.028/sq mi) is particularly useful). Thryduulf (talk) 17:36, 19 July 2024 (UTC)[reply]

Found a really clumsy and dirty technique: {{cvt|122|mi|km0|abbr=values|disp=preunit|km/1000 km<sup>2</sup>|mile/1000 sq mile}} displays as 122 km/1000 km² (196 mile/1000 sq mile)

This relies on km/km2 converting to mi/sqmi being the same ratio as mi to km - ie km/km2 is same as 1/km and 1/km -> 1/mi being the same ratio as mi -> km. Dirty, very dirty.

Sadly, this trick doesn't work for summits per area.  Stepho  talk  17:57, 19 July 2024 (UTC)[reply]

If there were a heap of these, new units for "1000 km2" and "100 sqmi" and "100 km2" could be defined. I'm not sure how clean the result would be but it might be reasonable. Johnuniq (talk) 03:20, 20 July 2024 (UTC)[reply]

A similar issue arises at Scandinavian mountains#Climate, permafrost and glaciers where there is a need to convert "1.17 °C /100 m" but the logical {{convert|1.17|C-change/e2m}} gives an error (1.17 C-change/e2m^{[convert: unknown unit]}). A quick search suggests that "°C /100m" (with that exact spacing) is used in at least three other articles. Thryduulf (talk) 11:30, 12 September 2024 (UTC)[reply]

At Lake Casitas#Operations, there is a conversion that is grammatically incorrect, and I'm wondering if there's a way to fix it. Whoever put the conversion in wanted it to read "x acre-feet of water" before the conversion, but as you can see, existing options do not seem to allow for that sort of construction. Thanks! 1980fast (talk) 21:57, 28 August 2024 (UTC)[reply]

It is possible, but it's ugly. The following shows what is currently in the article (first line) and what could be done (second line). I think the current convert is fine but it's your choice.

• up to {{convert|107,800|acre.ft|m3|abbr=off|sp=us}} of water per year → up to 107,800 acre-feet (133,000,000 cubic meters) of water per year
• up to {{convert|107,800|acre.ft|m3|disp=x| of water (|)|abbr=off|sp=us}} per year → up to 107,800 acre-feet of water (133,000,000 cubic meters) per year

See Help:Convert#Extra words. Johnuniq (talk) 04:38, 29 August 2024 (UTC)[reply]

Thanks! Actually, the current wording is indeed fine, because someone else fixed it already. It didn't look like the first line when I asked the question! :) I'd link to the revision that I saw, but I don't know how to do so.

I do have one question about your second line: what's the function of the pipe character in parentheses? 1980fast (talk) 19:48, 29 August 2024 (UTC)[reply]

@1980fast: Compare this:

• up to 107,800 acre-feet of water (133,000,000 cubic meters) per year

with this:

• up to 107,800 acre-feet of water 133,000,000 cubic meters per year

As you can see, it encloses the conversion in parentheses. --Redrose64 🌹 (talk) 20:37, 29 August 2024 (UTC)[reply]

To clarify further, it's not a "pipe character in parentheses", the pipe char separates the parameters " of water (" and ")". The first string goes before the converted quantity and the second goes after. Indefatigable (talk) 20:47, 29 August 2024 (UTC)[reply]

{{cvt|3.1|–|3.2|m|ft}} yields 3.1–3.2 m (10–10 ft) which is nonsense (it should be 10 ft). 2A06:C701:4F01:3E00:954F:E3C4:701B:2467 (talk) 15:52, 3 September 2024 (UTC)[reply]

It's designed so that if a range is fed in, a range will always come out. If you increase the precision, you will notice that the output does vary:

• 3.1–3.2 m (10–10 ft)
• 3.1–3.2 m (10–10 ft)
• 3.1–3.2 m (10.2–10.5 ft)
• 3.1–3.2 m (10.17–10.50 ft)
• 3.1–3.2 m (10.171–10.499 ft)
• 3.1–3.2 m (10.1706–10.4987 ft)

HTH. --Redrose64 🌹 (talk) 16:21, 3 September 2024 (UTC)[reply]

Is it possible to combine the "multiple components" form, like {{convert|11|ft|2|in|m}} and {{convert|4|ft|5|in|m}}, with the "range" form? The only way that I've found that works is {{convert|11+2/12|x|4+5/12|ft|m|abbr=on}} - this gives 11+2⁄12 ft × 4+5⁄12 ft (3.4 m × 1.3 m) which is technically correct, but not ideal. --Redrose64 🌹 (talk) 15:23, 29 September 2024 (UTC)[reply]

Sorry, no. The multiple units like feet/inches can have several components (miles, chains, ...) and making them work with a range was beyond me. However, if desperate, there is a dirty trick which I can't really recommend but which gives a reasonable result in this case:

• {{convert|3.40|x|1.35|m|ftin|order=flip}} → 11 feet 2 inches by 4 feet 5 inches (3.40 m × 1.35 m)
• {{cvt|3.40|x|1.35|m|ftin|order=flip}} → 11 ft 2 in × 4 ft 5 in (3.40 m × 1.35 m)

Johnuniq (talk) 23:00, 29 September 2024 (UTC)[reply]

OK, Thank you --Redrose64 🌹 (talk) 17:10, 30 September 2024 (UTC)[reply]

For Reciprocating engine#History {{convert|2,300|metric ton|short ton long ton|lk=on}} and {{convert|2,300|metric ton|ST LT|lk=on}} 2,300 metric tons (^{[convert: unknown unit]}) and 2,300 metric tons (2,535 short tons; 2,264 long tons) instead of {{convert|2,300|metric ton|short ton|lk=on}} or {{convert|2,300|metric ton|long ton|lk=on|sigfig=4}} 2,300 metric tons (2,535 short tons) or 2,300 metric tons (2,264 long tons) Peter Horn User talk 01:54, 6 October 2024 (UTC)[reply]

@Peter Horn: When a unit code such as short ton contains a space, use + to separate units:

• {{convert|2,300|metric ton|short ton+long ton|lk=on}} → 2,300 metric tons (2,500 short tons; 2,300 long tons)

Johnuniq (talk) 02:09, 6 October 2024 (UTC) Peter Horn User talk 02:41, 6 October 2024 (UTC)[reply]

Thanks. Peter Horn User talk 02:49, 6 October 2024 (UTC)[reply]

Input:

{{Convert|1|K|C F|abbr=~}}
{{Convert|1|C|F|abbr=~}}
{{Convert|1|C|F|abbr=off}}
{{Convert|1|K|C F|abbr=off}}
{{Convert|1|Celsius|F|abbr=~}}
{{Convert|1|Fahrenheit|Celsius}}
{{Convert|1|C|kelvin|abbr=~}}

Output:
1 K [K] (−272.15 °C; −457.87 °F)
1 °C [°C] (34 °F)
1 degree Celsius (34 degrees Fahrenheit)
1 kelvin (−272.15 degrees Celsius; −457.87 degrees Fahrenheit)
1 °C [°C] (34 °F)
1 Fahrenheit^{[convert: unknown unit]}
1 °C [°C] (^{[convert: unknown unit]})

Semi-expected output:
1: 1 kelvin [K]
2: 1 degree Celsius [°C]
3 & 4: N/A, working
5: 1 degree Celsius [°C]

And last 2, certainly slightly surprising behavior that it outputs the unit names but doesn't recognize some as input. But it does for Celsius. If that's known/intended behavior, ought to be documented somewhere. (There, then it's not a bug, b/c you documented it—now it's a feature )

Contrasted:
1 inch [in] (0.083 ft; 2.5 cm)
1 inch (2.5 cm)
1 kilometre (5.0 furlongs)
Slowking Man (talk) 23:14, 7 October 2024 (UTC)[reply]

Convert has a lot of quirks due to its long history. The proper documentation is at Module:Convert/documentation/conversion data#Temperature. Various summaries of the units are available but I don't like the advice they give for temperature because they suggest that {{convert|30|°C}} is the approved method whereas it should actually be {{convert|30|C}} on the basis that unit codes are intended to be easy to type and it is not necessary to remember that it is K (kelvin) but °C (degrees Celsius). At any rate, for obscure historical reasons, Celsius was defined as an alias for C but the other names were not defined. If anything, I would recommend removing Celsius. Johnuniq (talk) 01:05, 8 October 2024 (UTC)[reply]

I started wondering if the OP was more concerned about the fact that abbr=~ produces °C [°C]. That option is rarely used. Most units default to showing the name for the input (for example, 30 kilograms). Using abbr=~ would display 30 kilograms [kg]). That is, it shows the symbol as well as the name. It turns out that temperature units default to showing the symbol and you have to use abbr=off to make them show the name. That means you cannot also use abbr=~ so it is not possible to show the name and symbol for a temperature unit. That is not ideal but probably is not worth fixing. See Template talk:Convert/Archive December 2014#What happened with abbr=~ ? for a discussion of whether the option should be deprecated. Johnuniq (talk) 02:08, 8 October 2024 (UTC)[reply]

WMF needs to determine your IRL identity and insure your life for $10,000,000 -- the conservative cost of hiring a staff of coders to take over maintenance of convert, should the worst happen. EEng 03:24, 8 October 2024 (UTC)[reply]

I would take you up on that great idea if it were not for my nervousness regarding giving someone a $10,000,000 reason for me to disappear! Johnuniq (talk) 03:55, 8 October 2024 (UTC)[reply]

With the right paperwork, a "reported" death and a new life in Cuba, you could have a rather nice retirement plan :)

On an unrelated note, I'd completely forgotten that I had commented on this 10 years ago. But having never used it even once, I'm in favour of removing it. Is it used much?

Sounds like the OP's gripe is that Fahrenheit and kelvin are valid outputs but not valid inputs. Considering we also have meters, miles, feet, inches, etc as inputs, I tend to agree with him.  Stepho  talk  07:08, 8 October 2024 (UTC)[reply]

Gotta watch out for that template mafia. Extremely groan-worthy memeing attempt:

{{that's|how={{{mafia|{{{works}}}}}}}}

(for those not getting it) --Slowking Man (talk) 23:14, 8 October 2024 (UTC)[reply]

Hah, not surprising (I've seen scarier corner cases in old code for sure). Wanted to be helpful mainly and ensure this was known. Certainly understand if people aren't rushing in to overhaul the template code. Would be good to document the behavior somewhere I think. Where do people think is the best place to put that? Wouldn't mind writing up a note in the docs. Thanks for the expert knowledge! --Slowking Man (talk) 23:14, 8 October 2024 (UTC)[reply]