Mostrar código-fonte de Predefinição:Convert/doc

<noinclude>{{Em tradução}} {{Subpágina de documentação}}</noinclude>
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
{{Pdepreciada|Convert|Converter}}{{esotérico}}
<!--
{{Notícia|
{{convert/kt}}
{{cor|red|Os códigos <code>sqm</code> e <code>sqkm</code> também foram removidos. Use <code>m2</code> e <code>km2</code>.}}
}}-->

Esta predefinição pode ser utilizada para mostrar a medição das quantidades como primária e unidades convertidas secundárias, opcional com abreviatura ou barra, tais como a distância "{{convert|32|m|ft}}" ou temperatura "{{convert|18|°C|°F}}" ou "{{convert|18|°C|°F|disp=s}}" com opcional grafias E.U. ou hifenização.
<!--Favor revisar e corrigir This template can be used to show measurement quantities as primary and converted secondary units, with optional abbreviation or slash, such as distance "32 metres (100 ft)" or temperature "18 °C (64 °F)" or "18 °C/64 °F" with optional US spellings or hyphenation.-->
=== Uso ===
Valor único:
 <tt><nowiki>{{</nowiki>convert|''original_value''|''original_unit''|''conversion_unit''|''round_to''<nowiki>|...}}</nowiki></tt>

Faixa de valores (ver abaixo na lista de ''range'' opções):
 <tt><nowiki>{{</nowiki>convert|''orig_val1''|''range''|orig_val2|''original_unit''|''conversion_unit''|''round_to''<nowiki>|...}}</nowiki></tt>

*Numbers must be entered in unformatted form (without commas).  For negative numbers (i.e. temperatures or precision) use a hyphen as the minus sign for the input number.  Values output by the template will be displayed formatted and with a true minus sign where appropriate.  
*Optional parameters, in examples below, allow abbreviated units (abbr=on), or US spellings (sp=us for ''meter''), or slash separation (disp=s), or hyphenation (adj=on), etc.
*For this template many levels of [[Wikimotorpedia:Predefinição substituição|substituição]] are possible, hence doing this fully, step by step, is cumbersome, use [[Special:ExpandTemplates]] instead.
*The template has no in-built capacity for [[Análise dimensional]].  It is therefore up to the user to ensure that the input and output units are compatible.  Do not, for example, attempt to convert barrels to tonnes (but see {{Lp|bbl to t}}).  Also beware of units with similar names; the code <code>oz</code>, for example, is for the avoirdupois ounce (a unit of mass), do not use this if you want fluid ounces.
*The range functionality is not fully implemented for all units, so experimentation may be required.
*This documentation page tends to lag behind in terms of what the template can do.  For details see the talk page and its archives.

===Examplos===
====Valor único====
{| class="wikitable"
|'''Entrada'''||'''Mostra como'''
|-
|<nowiki>{{convert|3.21|kg|lb}}</nowiki>||{{convert|3.21|kg|lb}}
|-
|<nowiki>{{convert|3.21|kg|lb|0}}</nowiki>||{{convert|3.21|kg|lb|0}}
|-
|<nowiki>{{convert|0|kg|lb}}</nowiki>||{{convert|0|kg|lb}}
|-
|<nowiki>{{convert|6|ft|5|in|m}}</nowiki>||{{convert|6|ft|5|in|m}}
<!--This is currently broken, see talk page
|-
|<nowiki>{{convert|2|m|ftin}}</nowiki>||{{convert|2|m|ftin}}
-->
|-
|<nowiki>{{convert|18|°C|°F}}</nowiki>||{{convert|18|°C|°F}}
|-
| <nowiki>{{convert|1250|sqft|m2|lk=in|sigfig=2}}</nowiki> ||{{convert|1250|sqft|m2|lk=in|sigfig=2}}<br/>Veja que  'lk=in' aplica link apenas para unidade de entrada. Este exemplo é somente para ilustração, unidades comuns de medição não devem ser  lincadas. Ver: [[Wikipedia:Only make links that are relevant to the context|wp:overlink]].
|- 
|<nowiki>{{convert|20.5|km2|sqmi|lk=out|abbr=on}}</nowiki>||{{convert|20.5|km2|sqmi|1|lk=out|abbr=on}}<br/>Veja que 'lk=out' aplica link apenas para unidade de saída. Este exemplo é somente para ilustração, unidades comuns de medição não devem ser  lincadas. Ver: [[Wikipedia:Only make links that are relevant to the context|wp:overlink]].
|-
|<nowiki>{{convert|641|acre (unidade)|km2 sqmi|lk=on}}</nowiki>||{{convert|641|acre (unidade)|km2 sqmi|lk=on}}<br/>Veja que 'lk=on' aplica links para unidades de entrada e saída. Este exemplo é somente para ilustração, unidades comuns de medição não devem ser lincadas. See: [[Wikipedia:Only make links that are relevant to the context|wp:overlink]].
|-
|<nowiki>{{convert|641|acre (unidade)|km2 sqmi|2|lk=on}}</nowiki>||{{convert|641|acre (unidade)|km2 sqmi|2|lk=on}}<br/> Note that because 640 acres equals one square mile; 641 acres rounded to two decimal places equals 1.00&nbsp;sq&nbsp;mi.
|}

====Faixa de valores====
:''Nota: ainda não operacional para todas as unidades''
{| class="wikitable"
|'''Entrada'''||'''Mostra como'''
|-
|<nowiki>{{convert|60|and|170|kg|lb}}</nowiki>||{{convert|60|and|170|kg|lb}}
|-
|<nowiki>{{convert|60|to|170|kg|lb}}</nowiki>||{{convert|60|to|170|kg|lb}}
|-
|<nowiki>{{convert|60|to(-)|170|kg|lb}}</nowiki>||{{convert|60|to(-)|170|kg|lb}}
|-
|<nowiki>{{convert|60|-|170|kg|lb}}</nowiki>||{{convert|60|-|170|kg|lb}}
|-
|<nowiki>{{convert|60|by|120|m|ft}}</nowiki>||{{convert|60|by|120|m|ft}}
|-
|<nowiki>{{convert|60|x|120|m|ft}}</nowiki>||{{convert|60|x|120|m|ft}}
|-
|<nowiki>{{convert|60|+/-|10|m|ft}}</nowiki>||{{convert|60|+/-|10|m|ft}}
|}

A seguinte série de conversões não estão atualmente disponíveis:
*Temperature-based units (°C para °F, etc.) devido à complexidade da conversão
*Imperial and US gallon-based units
*Fuel consumption units (mpg, L/100km)
*Large scale units (e3, e6, e9)
*Combination-based units (ft&in, st&lb, lb&oz) devido à complexidade da conversão

===Parâmetros===
{| class="wikitable"
|-
! colspan="2" | 
|-
| Use [[Estados Unidos|US]] spelling || attach <code><nowiki>|sp=us</nowiki></code>
|-
| Make units [[Wikipedia:Manual of Style (links)|wikilinked]] || attach <code><nowiki>|lk=on</nowiki></code> to link all units<br> attach <code><nowiki>|lk=in</nowiki></code> to link only the input units<br> attach <code><nowiki>|lk=out</nowiki></code> to link only the output units<br>(The [[Wikipedia:Only make links that are relevant to the context|manual of style]] suggests that you should not link common units of measurement).
|-
| Use the adjective form || attach <code><nowiki>|adj=on</nowiki></code> (e.g. "The 190-foot (58 m) bridge" as opposed to "The 190 feet..."). This produces the adjective form—the unit name in the singular with a hyphen (according to the [[WP:HYPHEN|Manual of Style]]).
|-
| Abbreviate all units || attach <code><nowiki>|abbr=on</nowiki></code>
|-
| Use a / instead of ( ) || attach <code><nowiki>|disp=s</nowiki></code> (or  <code><nowiki>|disp=/</nowiki></code>) (e.g. 190&nbsp;foot/58&nbsp;metre).  Note that when using slashes all unit names either spelt out in full or abbreviated (where there exists an abbreviation).
|-
| Use in a table || attach <code><nowiki>|disp=table</nowiki></code> 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 <code><nowiki>|abbr=on</nowiki></code>, <code><nowiki>|lk=on</nowiki></code>, <code><nowiki>|lk=in</nowiki></code> or <code><nowiki>|lk=out</nowiki></code>. Example: [[Phnom_Penh#Highways_in_Phnom_Penh|here]]
|-
| Round to a specified number of significant figures|| attach <code><nowiki>|sigfig={some non-negative integer}</nowiki></code>. 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.
|-
| Let ''Convert'' decide the unit to convert to|| skip the ''convert to'' parameter (which would otherwise be third unnamed parameter) e.g. <code><nowiki>{{convert|100|mi|0}}</nowiki></code> gives ''{{convert|100|mi|0}}''.
|-
|Display input value as a fraction|| <nowiki>{{convert|3/8|in|mm|3|abbr=on}}</nowiki><font color=blue>'''→'''</font> {{convert|3/8|in|mm|3|abbr=on}} or <nowiki>{{convert|11+1/4|in|cm|2|abbr=on}}</nowiki><font color=blue>'''→'''</font>{{convert|11+1/4|in|cm|2|abbr=on}}
|}

====Parâmetros ainda em construção====
{| class="wikitable"
|-
! colspan="2" | Parâmetros ainda em construção.  Pode não funcionar em todas as situações
|-
|disp=ou||Similar ao disp=s exceto a palavra "ou" será colocado entre os valores.  Atualmente não trabalho com várias conversões (por exemplo, Litros para os EUA, e galões imperiais) (<nowiki>{{convert|20|mi|km|disp=or}}</nowiki>)--->({{convert|20|mi|km|disp=or}})
|-
|disp=tablecen||Similar ao disp=table exceto que os valores estarão  centrados dentro da coluna.  Ver as tabelas na [[La Nouvelle branch]] nos exemplos de uso.
|}

===Rounding===
''Convert'' supports four types of rounding:
;Rounding to a given precision 
:Specify the desired precision with the fourth unnamed parameter or third unnamed parameter in the case where the ''convert to'' parameter is skipped (see above).  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 <code><nowiki>|sigfig={some non-negative integer}</nowiki></code> 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 decimals remains the same if the conversion is a multiplication by a number between 0.2 and 2, is decreased by 1 if the factor is between 2 and 20, etc.) 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 kelvin, whichever is the most precise.

===Unidades suportadas ===
{{selfref|Ver também: [[Template:Convert/lista de unidades|Convert/lista de unidades]]}}
A tabela abaixo lista unidades suportadas por esta predefinição. Ela é dividida de acordo com a quantidade a ser medida. Nem todas as unidades suportadas estão listadas aqui, há links para listas completas para cada quantidade.
Os códigos listados na coluna ''código'' (coluna 3) são aceitos como entrada pela predefinição.
Estes podem ser usados como o segundo ou terceiro parâmetro sem nome. Para algumas unidades existem códigos alternativos. Eles estão listados entre parênteses e foram incorporados para tornar o código mais flexível para os editores, e.g. °F ''ou'' F  podem ser inscritos. 

Os códigos referidos nas colunas de ''combinações'' (coluna 7) pode ser usada para produzir conversões múltiplas. Eles só podem ser utilizados como o terceiro parâmetro sem nome, ex. <code><nowiki>{{convert|55|nmi|km mi}}</nowiki></code> produz "{{convert|55|nmi|km mi}}".

<div style="height: 400px; overflow: auto; padding: 3px; border:1px solid #AAAAAA; reflist4" >
{{Convert/lista de unidades}}
</div>

===Exemplos===
* Monitor de qualidade ou olhar os exemplos de {{Lp|Convert/check}}.

== {{Ver também}} ==
* {{Lp|Altura}} predefinição para o cálculo (corpo) de altura com precisão.
* {{Lp|Converter}}

<includeonly>
[[Categoria:!Predefinições de conversão]]

[[bn:টেমপ্লেট:Convert]]
[[ca:Plantilla:Convert]]
[[en:Template:Convert]]
[[et:Mall:Convert]]
[[fr:Modèle:Conversion]]
[[id:Templat:Convert]]
[[it:Template:Converti]]
[[ja:Template:Convert]]
[[ko:틀:단위 변환]]
[[map-bms:Cithakan:Convert]]
[[no:Mal:Convert]]
[[os:Шаблон:Convert]]
[[ro:Format:Conversie]]
[[sco:Template:Convert]]
[[simple:Template:Convert]]
[[tpi:Template:Convert]]
[[su:Citakan:Convert]]
[[th:แม่แบบ:Convert]]
[[vi:Bản mẫu:Convert]]
[[zh:Template:Convert]]
</includeonly>