Plantilla:Inflación

Documentación de la plantilla

Uso

Esta plantilla calcula la inflación en base a varios índices de inflación en conjuntos de datos. La plantilla utiliza un código de identificación para un índice de inflación (por lo general un código de país), un valor original, un original start_year y, o bien una referencia específica END_YEAR o por defecto el último año del final disponible en la actualidad, y calcula el valor equivalente histórico de cambios económicos entre los años originales y de referencia.

Aparte de una manera conveniente para calcular los valores de diferentes períodos de tiempo especificados, esta plantilla permite un cálculo actualizado periódicamente de forma automática del valor basado en los más recientes datos de inflación disponibles. Cada vez que se actualizan las tablas de inflación, lo que podría ser cada año, todos los artículos que utilizan esta plantilla tienen sus valores mostrados actualizados en consecuencia.

{{Inflación|código_país|valor|año_inicio}}
{{Inflación|código_país|valor|año_inicio|año_final}}
{{Inflación|código_país|valor|año_inicio|r=decimales|fmt=c}}
{{Inflación|código_país|valor|año_inicio|r=decimales|fmt=eq}}
{{Inflación|código_país|valor|año_inicio|r=decimales|fmt=eq|cursign=X}}

Los países admitidos se enumeran a continuación, con su índice y los períodos de datos disponibles:

Nombre del país	`Código_país`	Año de inicio (mínimo) para `año_inicio`
Australia	AU	1901
Canadá	CA	1916
Alemania	DE	1882
India	IN	1953
Japón	JP	1946
Filipinas	PH	1985
Reino Unido	UK	1209
Estados Unidos	US	1800

NOTA: De momento (septiembre de 2019), solo están habilitados los cálculos para el dólar estadounidense (US $) y la libra esterlina (UK £).

Parámetros

código_país: El código correspondiente para cada país. (Véanse los códigos en la tabla anterior) y véase también código de país.
valor: Valor numérico representativo de la inflación de dicho país. NOTA: No puede llevar símbolo monetario.
año_inicio: El año de inicio para determinar la inflación por país. NOTA: Depende de la cantidad de años permitidos para cada país. (Ver los años en tabla anterior)
año_final: El año de finalización para determinar la inflación por país en un rango de tiempo (en años). Si se proporciona, debe ser más alto (más tarde) que año_inicio, pero no más que el año en curso (2016). Si no se proporciona, se pondrá por defecto el año más "reciente";
r=digit: Establece el dígito en el que deberá redondearse al valor, por defecto a "0" si no se especifica, es decir, sin centavos.
fmt=c: insertará comas en el valor de la inflación.
fmt=eq: mostrará un equivalente a la frase.
cursign=X: establecerá el Símbolo monetario cuando se utiliza fmt=eq (por defecto: $).

Ejemplos

{{Inflación|US|595|1982}} = 1671
US $595 (${{Inflación|US|595|1982|fmt=c}} actualmente) = US $595 ($1671 actualmente)
US $595 ({{Inflación|US|595|1982|fmt=eq}}) = US $595 (1671)
{{Inflación|US|800|1942|r=-3|fmt=eq}} = 13000
{{Inflación|US|100|2010|2012|r=2|fmt=eq}} = 105.28
{{Inflación|UK|1|1323|fmt=eq}} = 700
{{Inflación|UK|1|1323|fmt=eq|cursign=£}} = 700

Introducir parámetros inválidos produce un enlace al artículo NaN:

{{Inflation}} = NaN
{{Inflation|US|1000000|1200|3000}} = NaN
{{Inflation|UK|1000000|2005|2004}} = NaN

Consejos y trucos

Conversión de moneda

Esta plantilla no convierte entre distintas monedas. Por lo tanto, si desea saber lo que valen hoy en día la cantidad de 1.000 libras en 1960, entrando 24497.84 proporcionaría un resultado todavía en libras, y no en euros. En consecuencia, si se necesita un resultado en otra moneda, por ahora hay que hacer la conversión manualmente, como en el siguiente ejemplo que utiliza el tipo de conversión definida de 1€ = 1,08 £:

{{#expr:({{Inflación|UK|1000|1960}} / 1.08) round 2}} → 22683.19

Redondeo

Por defecto, los valores se calculan a la unidad, pero los valores muy bajos (de solo centavos) no son deseables. Se puede especificar el redondeo con el {{param|r}}. Este parámetro determina el número de decimales. Para obtener el uso de centavos, indicar |r=2, pero otros valores pueden ser usados, incluyendo los negativos: |r=-3, por ejemplo, redondea al millar más próximo; |r=-6 al millón más cercano, y así sucesivamente. Es aconsejable evitar el exceso de precisión: incluso si el valor de inicio se conoce con exactitud, el resultado de la plantilla no lo será, porque las tablas de índice de inflación tienen rara vez una precisión de más de aproximadamente un 1%, y se utiliza una larga sucesión de años enteros.

Resultados demasiado largos

Resultados muy grandes se expresan en notación científica ("1.2E+14" en lugar de "120000000000000"), lo que normalmente no es deseable. Una solución consiste en expresar el valor a calcular con menos dígitos, añadir texto y coeficiente multiplicador como "millones" después del resultado, utilizando el botón "mostrar vista previa" tantas veces como sea necesario, cambiando los parámetros hasta que se encuentre el mejor resultado:

${{Inflación|US|1000000000000|1900|r=-11|fmt=c}} = $32600000000000
${{Inflación|US|10000000000000|1900|r=-12|fmt=c}} = $3.26E+14
${{Inflación|US|10000000000|1900|r=-9|fmt=c}} miles = $326000000000 miles
${{Inflación|US|10000000|1900|r=-6|fmt=c}} millones = $326000000 millones
${{Inflación|US|10000|1900|r=-3|fmt=c}} miles de millones = $326000 billones
${{Inflación|US|10|1900|fmt=c}} trillones = $326 trillones

La siguiente sección proporciona una forma directa para evitar este escenario de prueba y error.

Formato de precio

{{Formatprice}} es una plantilla diseñada específicamente para mostrar valores de precios, tanto grandes como pequeños, de manera legible. Por ejemplo, en lugar de mostrar la totalidad de un gran número como "953,783,409,856.12", lo mostraría como "954 mil millones", mientras que pequeños números tienen su parte de centavos apareciendo como se esperaba, "1234.5" siendo apropiadamente mostrado como "1234,50".

${{Formatprice|{{Inflation|US|10000000000000|1900}}}} = $326 billones
${{Formatprice|{{Inflation|US|1000000|1990}}}} = $2.07 millones
£{{Formatprice|{{Inflation|UK|1000|1323}}}} = £700 mil

Documentación

Es una buena práctica proporcionar una referencia válida para los precios calculados con esta plantilla en los artículos donde se usa. La plantilla {{Inflation-fn|country}} fue desarrollada para facilitar esta tarea. Acepta como su único parámetro los mismos códigos de país utilizados aquí, y generará una o más notas al pie apropiadas. Por lo general, así es como se ve un fragmento de texto que lo usa:

En 1985 un costo unitario en promedio $ 1,040. Esto es {{Inflation|US|1040|1985|fmt{{=}}eq}}}}.{{Inflation-fn|US}}

Como resultado de este código convertido (obsérvese el enlace de la nota al pie de página al final):

En 1985 un costo unitario en promedio $ 1,040. Esto es 2620.^[1]

La nota al pie así generada aparece siempre {{reflist}} o <references /> en el artículo donde se usa la plantilla, generalmente en su sección "Referencias". Véase a continuación el ejemplo en vivo en el propio documento en la sección Referencias, o hágase clic en la nota al pie generada arriba para acceder a ella.

Limitaciones

Actualmente no es posible "deflactar" una cantidad de dinero a lo que hubiera sido su valor equivalente en un año previo. Si se necesita esta funcionalidad, solicítela en talk page. Agregarlo no es difícil, pero no tiene sentido hacerlo antes de que alguien realmente lo necesite.
Substitution no es compatible en absoluto. Tratando de {{subst:Inflation|...}} solo daría como resultado una secuencia larga de código de analizador incorporado sin ningún beneficio directo. Si se necesita obtener un precio deflactado solo una vez, utilícese la página especial ExpandTemplates, luego cópiese el resultado y péguese en la ubicación deseada.

Actualización de los datos de inflación

Para evitar que la información quede desactualizada, es necesario añadir periódicamente a cada moneda su índice de inflación anual.

En el caso del dólar estadounidense (la moneda que suele aparecer con mayor frecuencia), se deben seguir los pasos siguientes:

[1]: Editar la Plantilla:Inflation/US/dataset, añadiendo al final las nuevas líneas procedentes de su template equivalente en inglés en:Template:Inflation/US/dataset.
[2]: Debe actualizarse la referencia en la Plantilla:Inflation-fn (copiando y pegando el texto procedente de en:Template:Inflation-fn)
[3]: Y debe ponerse al día el último año en la Plantilla:Inflation-year (copiando y pegando el texto procedente de en:Template:Inflation-year)

Para el resto de monedas, el proceso es el mismo, pero solo repitiendo el paso [1] (una vez que se completen los datos faltantes de las propias monedas).

(NOTA: Actualizados el dólar estadounidense y la libra esterlina en junio de 2022)

Véase también

{{Formatprice}}

Referencias

↑ 1634–1699: McCusker, J. J. (1997). How Much Is That in Real Money? A Historical Price Index for Use as a Deflator of Money Values in the Economy of the United States: Addenda et Corrigenda. American Antiquarian Society. 1700–1799: McCusker, J. J. (1992). How Much Is That in Real Money? A Historical Price Index for Use as a Deflator of Money Values in the Economy of the United States. American Antiquarian Society. 1800–present: Federal Reserve Bank of Minneapolis. «Consumer Price Index (estimate) 1800–». Consultado el April 16, 2022.

Sin descripción.

Parámetros de la plantilla[Editar los datos de la plantilla]
Parámetro		Descripción	Tipo	Estado
Código de país	`1`	El código correspondiente para cada país (véanse los códigos en la documentación) Ejemplo US	Desconocido	opcional
Valor	`2`	Valor numérico representativo de la inflación de dicho país. NOTA: No puede llevar símbolo monetario.	Número	opcional
Año de inicio	`3`	El año de inicio para determinar la inflación por país. NOTA: Depende de la cantidad de años permitidos para cada país. (Ver los años mínimos en la documentación) Ejemplo 1980	Fecha	opcional
Año final	`4`	El año de finalización para determinar la inflación por país en un rango de tiempo (en años). Si se proporciona, debe ser más alto (más tarde) que Año de inicio, pero no más que el año en curso. Si no se proporciona, se pondrá por defecto el año más "reciente";	Fecha	opcional
Dígitos de redondeo	`r`	Establece el dígito en el que deberá redondearse al valor, por defecto a "0" si no se especifica, es decir, sin centavos.	Número	opcional
Formato	`fmt`	Establece un formato para presentar los valores. Los valores admitidos son: c (inserta comas), eq (muestra un equivalente a la frase)	Desconocido	opcional
Símbolo monetario	`cursign`	Establecerá el Símbolo monetario cuando se utiliza fmt=eq (por defecto: $).	Desconocido	opcional

Esta documentación está transcluida desde Plantilla:Inflación/doc.
Los editores pueden experimentar en la zona de pruebas (crear) y en los casos de prueba (crear) de la plantilla.
Por favor, añade las categorías en la subpágina de documentación. Subpáginas de esta plantilla.

[inflation-US-1] 1634–1699: McCusker, J. J. (1997). How Much Is That in Real Money? A Historical Price Index for Use as a Deflator of Money Values in the Economy of the United States: Addenda et Corrigenda. American Antiquarian Society. 1700–1799: McCusker, J. J. (1992). How Much Is That in Real Money? A Historical Price Index for Use as a Deflator of Money Values in the Economy of the United States. American Antiquarian Society. 1800–present: Federal Reserve Bank of Minneapolis. «Consumer Price Index (estimate) 1800–». Consultado el April 16, 2022.

[1]