Plantilla:Convertir/doc

Esta es la subpágina de documentación para Plantilla:Convertir. Contiene información de uso, categorías y otros contenidos que no forman parte de la plantilla original.

Esta plantilla utiliza el módulo ConvertirAux. Antes de modificarla, deberías familiarizarte con las funciones de la extensión Scribunto y el lenguaje de programación Lua.

El propósito de esta plantilla es mostrar cantidades en una visualización primaria y secundaria, tal como 32 metros (105 pies), o 18 grados Celsius (64,4 °F).

Formato general

{{convertir|valor|unidad_original|unidad_de_conversión|redondear_a|disp=|sing=|lk=|abr=|op=}}

Otros formatos

• Valor a convertir expresado como fracción:

{{convertir|valor (n/m), (a b/c) ó (a+b/c)|unidad_original||redondear_a|disp=|sing=|lk=|abr=}}

• Segunda unidad por defecto:

{{convertir|valor|unidad_original||redondear_a|disp=|sing=|lk=|abr=}}

• Introducción de intervalos:

{{convertir|valor_1|a|valor_2|unidad_original|unidad_de_conversión|redondear_a|disp=|sing=|lk=|abr=}}

o también:

{{convertir|valor_1-valor_2|unidad_original|unidad_de_conversión|redondear_a |disp= |sing= |lk= |abr=}}

o también:

{{convertir|valor (n m), (n-m) ó (n/m)|unidad_original||redondear_a|disp=|sing=|lk=|abr=|op=n}}

• Introducción de tríos de datos:

{{convertir|n1 x n2 x n3|unidad_original|unidad_de_conversión|redondear_a|disp=|sing=|lk=|abr=}}

• Entrada en pies y pulgadas:

{{convertir|valor_pies|ft|valor_pulgadas|in|unidad_de_conversión|redondear_a|disp=|sing=|lk=|abr=}}

• Entrada en millas y yardas:

{{convertir|valor_millas|mi|valor_yardas|yd|unidad_de_conversión|redondear_a|disp=|sing=|lk=|abr=}}

• Entrada en millas y cadenas:

{{convertir|valor_millas|mi|valor_cadenas|ch|unidad_de_conversión|redondear_a|disp=|sing=|lk=|abr=}}

• Entrada en toneladas largas y centenas:

{{convertir|valor_toneladas_largas|LT|valor_centenas|Lcwt|unidad_de_conversión|redondear_a|disp=|sing=|lk=|abr=}}

• Entrada en toneladas cortas y centenas:

{{convertir|valor_toneladas_cortas|ST|valor_centenas|Scwt|unidad_de_conversión|redondear_a|disp=|sing=|lk=|abr=}}

• Salida en (pies y pulgadas) o en (yardas, pies y pulgadas):

{{convertir|valor|unidad_original|ftin ó ydftin|redondear_a|disp=|sing=|lk=|abr=}}

• Salida simultánea en varias unidades distintas:

{{convertir|valor|unidad_original|unidad_de_conversión_1 unidad_de_conversión_2 unidad_de_conversión_n|redondear_a|disp=|sing=|lk=|abr=}}

El resultado se redondea a la potencia en base 10 indicada por el número elegido para redondear. Por ejemplo, si el resultado es 8621 y el número de redondeo es '-2', el resultado será 8600. Si el resultado es '234,0283043' y el número de redondeo es '0', el resultado será 234.

Las abreviaturas a la derecha de las unidades son las abreviaturas que pueden ser introducidas cuando se usa la plantilla. Después de varias revisiones de esta plantilla, algunas unidades han incorporado abreviaturas múltiples para hacer el código más flexible a los editores, p. ej. se puede introducir °F o F. Si bien no son las abreviaturas correctas, las abreviaturas correctas se mostrarán al utilizar {{convertir}}.

Para añadir una nueva unidad, se debe editar la plantilla {{Convertir/ud}}, y seguir el procedimiento siguiente:

• Añadir una nueva línea siguiendo el modelo de las existentes, con las abreviaturas que se van a poder utilizar en {{convertir}}( separadas por | y colocadas antes del signo = igual), y a continuación, los siete parámetros separados por !, que se corresponden con:

1) El nombre en la Wikipedia del enlace con el artículo de la unidad

2) La unidad en singular

3) La unidad en plural

4) Su abreviatura

5) La unidad por defecto en la que se debe convertir (para el caso de que no se indique en la plantilla)

6) La fórmula de cálculo con la que se debe convertir a la unidad base

7) La unidad base a la que se refiere la fórmula de cálculo. Para que los cálculos sean correctos, es imprescindible que todas las fórmulas de las unidades de un mismo tipo (longitud; volumen; velocidad...) estén expresadas respecto a la misma unidad base.

• Por ejemplo, para la unidad nudo (velocidad):

|nudo|kt = nudo (velocidad) ! nudo ! nudos ! ns ! km/h ! 0.514444 ! m/s 

• Así, se pueden relacionar los nudos con cualquier otra unidad de velocidad:

Utilizando {{convertir|10|nudo|pie:s mph m/s km/h|2}}, resulta: 10 nudos (16,88 pies/s; 11,51 mph; 5,14 m/s; 18,52 km/h)

Utilizando {{convertir|1|kt|pie:s mph m/s km/h|2}}, resulta: 1 nudo (1,69 pies/s; 1,15 mph; 0,51 m/s; 1,85 km/h)

• En la mayoría de los casos, basta con indicar el número de veces que una determinada unidad contiene a la unidad base. Por ejemplo, en los datos del kilómetro:

|km = kilómetro ! kilómetro ! kilómetros ! km ! mi ! 1000 ! m 

El penúltimo campo vale 1000 porque un kilómetro mide 1000 metros, es decir: m = km * 1000

• Existen transformaciones especiales, como el caso de la conversión de temperaturas, en las que en la fórmula se deben expresar el coeficiente de conversión y la constante a sumar con su signo. Los tres deben ir separados por blancos. Por ejemplo, en el caso del paso de grados Fahrenheit a Centígrados, los datos del grado Fahrenheit son:

|°F|F = grado Fahrenheit ! grado Fahrenheit ! grados Fahrenheit ! °F ! C ! 0.55555555555 - 32 ! C

El penúltimo campo vale 0.55555555555 - 32 porque la fórmula que relaciona ℃ y ℉ es C = 0.55555555555 * F - 32

• Existe un último tipo de transformación, en la que las unidades son inversamente proporcionales, como en el caso del consumo de combustible expresado en km/l y en l/100km. Los datos del consumo por cien kilómetros en función de los km recorridos por litro, son:

|l/100km = litro por cada 100 kilómetros ! litro por cada 100 kilómetros ! litros por cada 100 kilómetros ! L/100 km ! km/l ! 100 / 1 ! km/l

El penúltimo campo vale 100 / 1 porque la fórmula que relaciona ambas unidades es km/l = 100 / (l/100km)

• {{Pie en a m}} >> Plantilla para pasar de pies y pulgadas a metros (controlando abreviaturas utilizables)
• {{Altura}} >> Plantilla para pasar de pies y pulgadas a metros y al revés
• {{Ftin}} >> Plantilla para pasar de pies a pies y pulgadas
• {{Ydftin}} >> Plantilla para pasar de yardas a yardas, pies y pulgadas