Bản mẫu này được sử dụng ở khoảng 75.000 trang, vì thế những thay đổi đến nó sẽ hiện ra rõ ràng. Vui lòng thử nghiệm các thay đổi ở trang con /sandbox, /testcases của bản mẫu, hoặc ở không gian người dùng của bạn. Cân nhắc thảo luận các thay đổi tại trang thảo luận trước khi áp dụng sửa đổi.
Tùy cách sử dụng, bản mẫu này có thể làm tròn giá trị chuyển đổi, đặt liên kết đến bài về các đơn vị, viết tắt các đơn vị, và trang trí bằng đủ thứ cách như: dấu ngoặc, dấu gạch chéo, "hoặc", dấu phẩy, "đến", và dấu gạch nối (ngắn hay dài). Các kiểu trình bày bao gồm: "32 mét (105 ft)" và "32 mét hay 105 foot" cho chiều dài; "18 °C (64 °F)" và "18 °C (64 °F)[chuyển đổi: tùy chọn không hợp lệ]" cho nhiệt độ; "55,0 kg (121,3 lb)" hay "65 đến 80 kg (143 đến 176 lb)" cho trọng lượng; v.v. Để biết đơn vị nào được hỗ trợ, hãy xem: Mô đun:Convert/documentation/conversion data/tài liệu#Conversions.
Các tùy chọn bao gồm:
lk=in, abbr=on, adj=mid, disp=or, disp=table, và sortable=on (được giải thích ở dưới). Theo mặc định, bản mẫu này cho ra số tròn để thích hợp với độ chính xác của giá trị cho vào; để tùy biến chế độ này, có thể sử dụng sigfig=3 hoặc tham số cuối, thí dụ bổ sung -2 để cho ra vị trí hàng trăm.
Một giá trị:
{{convert|giá trị gốc|đơn vị gốc|đơn vị chuyển đổi|vị trí làm tròn|...}}
Dãy giá trị (xem danh sách tùy chọn dãy ở dưới):
{{convert|giá trị gốc 1|dãy|giá trị gốc 2|đơn vị gốc|đơn vị chuyển đối|vị trí làm tròn|...}}
Các số được cho vào cần phải dùng quy tắc đánh số tiếng Việt, tức là phân tách phần thập phân bằng dấu phẩy và (tùy chọn) phân tách phần ngàn bằng dấu chấm. Nếu bài rõ ràng sử dụng kiểu phân tách Mỹ (ngược của quy kiểu tiếng Việt), bài sẽ được xếp vào Thể loại:Bài có giá trị chuyển đổi không chính xác. Các số âm (thí dụ nhiệt độ hoặc độ chính xác) phải được cho vào với dấu nối ngắn của ASCII (-). Bản mẫu sẽ trang trí các giá trị và sử dụng dấu trừ đúng (−) khi nào cần.
Những tham số tùy chọn trong các ví dụ ở dưới viết tắt các tên đơn vị (abbr=on), hoặc chia hai đơn vị bằng dấu chéo (disp=s), v.v.
Vì bản mẫu này nhúng rất nhiều cấp bản mẫu phụ, để sao chép nguyên mã nguồn kết quả của bản mẫu này, hãy sử dụng công cụ Mở rộng các bản mẫu thay vì từ khóa subst: hay thế:.
Bản mẫu không có chức năng để phân tích thứ nguyên. Do vậy, bạn cần phải chắc chắn rằng các đơn vị gốc và chuyển đổi phù hợp với nhau. Chẳng hạn đừng cố chuyển đổi thùng qua tấn (nhưng xem {{bbl to t}}). Ngoài ra, coi chừng những đơn vị có tên nghe giống nhau; chẳng hạn mã oz dành cho ounce avoirdupois để đo khối lượng, trong khi impfloz (Anh) và USoz dành cho ounce chất lỏng để đo thể tích.
Nếu cố chuyển đổi từ một đơn vị qua cùng đơn vị đó (ví dụ km qua km), bản mẫu sẽ bị vòng lặp vô hạn (sẽ được chặn bởi bộ xử lý).
Tính năng dãy chưa hỗ trợ tất cả mọi đơn vị, nên phải thử trước khi lưu trang.
Ví dụ
Một giá trị
Ví dụ
Sẽ cho
{{convert|3,21|kg|lb}}
3,21 kilôgam (7,1 lb)
{{convert|3,21|kg|lb|0}}
3,21 kilôgam (7 lb)
{{convert|10|kg |lb |disp=or}}
10 kilôgam hay 22 pound
{{convert|6|ft|5|in|m}}
6 foot 5 inch (1,96 m)
{{convert|2|m|ftin}}
2 mét (6 ft 7 in)
{{convert|10|mi}}
10 dặm (16 km)
{{convert|100|mpgus}}
100 dặm trên galông Mỹ (2,4 L/100 km; 120 mpg‑Anh)
{{convert|120|km/h}}
120 kilômét trên giờ (75 mph)
{{convert|18|°C|°F}}
18 °C (64 °F)
{{convert|1250|sqft|m2|lk=in|sigfig=2}}
1.250 foot vuông (120 m2) Lưu ý: lk=in chỉ đặt liên kết cho đơn vị gốc. Ví dụ này chỉ hướng dẫn cách đặt liên kết; không nên đặt liên kết cho những đơn vị thường gặp.
{{convert|20,5|m3|cuyd|lk=out|abbr=on}}
20,5 m3 (26,8 yd khối) Lưu ý: lk=out chỉ đặt liên kết cho đơn vị chuyển đổi, cu yd.
{{convert|641|acre|km2 sqmi|lk=on}}
641 mẫu Anh (2,59 km2; 1,002 dặm vuông Anh) Lưu ý: lk=on đặt liên kết cho cả hai đơn vị. Không nên đặt liên kết cho những đơn vị thường gặp.
{{convert|641|acre|km2 sqmi|2|lk=on}}
641 mẫu Anh (2,59 km2; 1,00 dặm vuông Anh) Tuy 640 mẫu Anh bằng 1 dặm vuông theo định nghĩa, nhưng 641 mẫu Anh được làm tròn ở hai con số là 1,00 dặm vuông.
gắn |lk=on để đặt liên kết cho cả hai đơn vị (mặc định: lk=off) gắn |lk=in để chỉ đặt liên kết cho đơn vị gốc gắn |lk=out để chỉ đặt liên kết cho đơn vị chuyển đổi (Cẩm nang về vă phong không khuyến khích đặt liên kết cho những đơn vị thường gặp.)
Thêm giới từ đằng trước
gắn |adj=mid (ví dụ "Cầu cao 190 foot (58 m)" bằng: |adj=mid|cao) Tham số làm tròn được cho đằng sau giới từ: "giới từ|0".
Viết tắt hay viết ra các đơn vị
gắn |abbr=on để hiện các ký tự đơn vị (mặc định: abbr=off) gắn |abbr=none để viết đầy đủ các tên đơn vị gắn |abbr=in để viết tắt đơn vị gốc gắn |abbr=out để viết tắt đơn vị chuyển đổi gắn |abbr=values để ẩn các đơn vị và chỉ hiện các giá trị. Chẳng hạn {{convert|6|mi|abbr=values}} sẽ cho: 6 (9,7).
Change "( )" to display other separators
attach |disp=comma to put comma, not brackets/parentheses attach |disp=or to put "or" between units attach |disp=s (or |disp=/) for slash (e.g. 190 foot/58 metre). The default value is: disp=b for brackets/parentheses.
Change "( )" to customized separators
attach |disp=x| (begin | end) to show "xx (begin yy end)" attach |disp=x|; to show "xx; yy" attach |disp=x| (same as |) to show "xx (same as yy)".
Display output only
attach |disp=output only to show result number & unit attach |disp=output number only to show just number Note when using "disp=output only" then the unit name can still be shown as full words by abbr=none, or linked by lk=on.
Display units inverted as reverse order
attach |disp=flip to reverse the order & show output unit first So, {{convert|6|km|disp=flip}} shows "3.2 mi (6 kilometres)". To get symbol "km" use abbr=in, to abbreviate the input unit.
Display unit name (only)
attach |disp=unit to show the unit name for a symbol The unit name will be plural when the amount is not 1, or hyphenated when adj=on. So, {{convert|2|cuyd|disp=unit}} shows "cubic yards" plural.
Display amounts as table cells
attach |disp=table (or |disp=tablecen) Note: For use in tables, the template must start on a new line after a pipe. Only the number will be displayed unless you set |abbr=on, |lk=on, |lk=in or |lk=out. Example: here
Round to a specified number of significant figures
attach |sigfig={some non-negative integer}. In the case of temperatures Celsius or Fahrenheit this refers to the difference with the absolute-zero temperature. For example, at room temperature two significant digits means rounded to tens of degrees.
Round by 5
attach |disp=5 to round the output amount to the nearest 5 units. Not supported for all options.
Let Convert decide the unit to convert to
put zero (0) or skip the convert to parameter (the 3rd unnamed parameter) e.g. {{convert|100|mi|0}} gives 100 dặm (161 km).
Display input value with a fraction
{{convert|3/8|in|mm|3|abbr=on}}→3⁄8 in (9,525 mm) or {{convert|11+1/4|in|cm|2|abbr=on}}→11+1⁄4 in (28,58 cm)
attach |sortable=on to generate a hidden sort key (in the form of <span style="display:none">00000005</span>) so that sortable tables will sort correctly. This takes the first numeric value and left pads it with zeros to 16 places. It ignores any additional values, ie, if you use 6|ft|2|in as the value, it will only use the 6 for the sort key. This will cause numeric values to sort in numeric order, ie: 5, 10, 15 instead of 10, 15, 5.
Tham số đang phát triển
Parameters still under construction. May not work in all situations
Round by 5
attach |disp=5 to round output to nearest 5 units. Might not work when linking unit names.
disp=tablecen
Similar to disp=table except that the values with be centered within the column. See the tables at La Nouvelle branch, BM-21 Grad for in use examples.
disp=comma
Similar to disp=s except the two values will be separated by a comma, for situations where the first value is already within parentheses. See the Geography tables on Labrador for an example.
abbr=in
Abbreviates only the input unit.
abbr=out
Abbreviates only the output unit.
abbr=comma
Abbreviates (removes) commas. This is a limited, temporary option, until comma=off can be implemented. For ranges, using abbr=comma conflicts with internal options, so instead, append "nocomma" to a range-word: tonocomma, bynocomma, andnocomma, -nocomma & xnocomma.
abbr=mos
For ranges, abbreviates with the input unit repeated, twice. Not to be confused with the specifications at .
số hàng số quan trọng sau dấu thập phân hoặc, nếu là số âm, lũy thừa của 10
Số
tùy chọn
đặt liên kết vào các đơn vị
lk
“on” tất cả, “in” số cho vào, “out” số cho ra, hoặc “off” không đặt liên kết
Mặc định
off
Chuỗi ngắn
tùy chọn
viết tắt
abbr
“on” viết tắt các ký hiệu đơn vị, “off” viết đầy đủ các tên đơn vị, “in” viết tắt đơn vị cho vào, “out” viết tắt đơn vị cho ra, “values” ẩn các tên đơn vị
Số
tùy chọn
dạng
disp
hiển thị số lượng biến đổi … “or” đằng sau ‘hoặc’, “p” trong ngoặc đơn, “x” với tiền tố và hậu tố tùy biến, “table”/“tablecen”, “output only” ẩn số lượng cho vào, “output number only” ẩn số lượng cho vào và đơn vị cho ra, “flip” đằng trước số lượng cho vào, “unit” chỉ hiển thị đơn vị cho vào; nếu giá trị là con số, nó là độ chính xác
Mặc định
p
Số
tùy chọn
chìa khóa sắp xếp?
sortable
“on” đặt chìa khóa sắp xếp ẩn
Số
tùy chọn
Số tròn
Convert supports four types of rounding:
Rounding to a given precision
Specify the desired precision with the fourth unnamed parameter (or third unnamed parameter if the "convert to" parameter is omitted; or fifth unnamed parameter if a range is specified; or fourth unnamed parameter again if a range is specified and the "convert to" parameter is omitted; needs to be replaced with a "precision" named parameter). The conversion is rounded off to the nearest power of 1/10 this number. For instance, if the result is 8621 and the round number is '-2', the result will be 8600. If the result is '234.0283043' and the round number is '0', the result will be 234.
Rounding to a given number of significant figures
Specify the desired number of significant figures using |sigfig={some non-negative integer} as noted above.
Combine both of the above
If both the desired precision and the desired number of significant figures are specified, the conversion will be rounded to the least precise of these.
Default rounding
If neither the desired precision nor the desired number of significant figures are specified, the conversion will be rounded either to a comparable precision as the input value (the number of digits after the decimal point—or the negative of the number of non-significant zeroes before the point—is increased by one if the conversion is a multiplication by a number between 0.02 and 0.2, remains the same if the factor is between 0.2 and 2, is decreased by 1 if it is between 2 and 20, and so on) or to two significant figures, whichever is the most precise. An exception to this is temperature wherein the conversion will be rounded either to precision comparable to that of the input value or to that which would give three significant figures when expressed in kelvins, whichever is the most precise.
The table below lists units supported by this template. It is divided up according to the quantity being measured. Not all supported units are listed here; there are links to complete lists for each quantity.
The codes listed in the code column (column 3) are accepted as input by the template.
These can be used as the second or third unnamed parameter. For some units there exist alternative codes. These are listed in brackets and have been incorporated to make the code more flexible for editors, e.g. °F or F may be entered.
The codes listed in the combinations column (column 7) can be used to produce multiple conversions. They can only be used as the third unnamed parameter, e.g. {{convert|55|nmi|km mi}} produces "55 hải lý (102 km; 63 mi)".
Danh sách các đơn vị chính được hỗ trợ trong {{Convert}}
Hướng dẫn
hệ đo lường
đơn vị
mã (khác)
ký hiệu/viết tắt
ghi chú
hệ số chuyển đổi
các tổ hợp
hệ đo lường bao gồm đơn vị này
tên đơn vị
các mã có thể cho vào bản mẫu
các ký hiệu hay chữ viết tắt được cho ra
ghi chú về các đơn vị hoặc cách sử dụng nó trong bản mẫu
hệ số được sử dụng để chuyển qua lại đơn vị gốc SI
