틀:인플레이션

틀 설명문서[보기] [편집] [역사] [새로 고침]

이 틀은 기본적으로 소비자 물가의 인플레이션을 계산하는 틀입니다. 그러나 하위 틀을 추가하면 GDP등도 계산할수 있습니다.

인플레이션 데이터셋을 변경시 꼭 마지막 년도 뒤에다가 |#default= 을 붙여주셔야 최근 년도로 정상적으로 작동합니다!

이 틀은 구조가 복잡하고, 많은 기능을 포함하고 있습니다.
틀의 구조를 충분히 이해하기 전까지는 이 틀을 바꾸지 마시고, 편집 후 문제가 생기면 바로 되돌리기 해 주세요. 틀의 시험은 /시험장에서 해볼 수 있습니다.

이 틀은 루아를 사용합니다.

모듈:Math

본 틀은 특정국 소비자 물가지수의 인플레이션율을 제시합니다.

국가의 약칭 (대한민국: KR, 미국: US)과 start_year (시작 연도)를 입력하면 그 연도로부터 최근 연도까지의 물가지수 인플레이션율을 반환합니다.^[1] end_year (끝 연도)를 사용하면 두 연도 사이의 인플레이션률을 계산할 수도 있습니다.

각국의 인플레이션 통계는 하위 틀을 통해 편집과 수정이 이루어지고 있습니다. 대한민국의 인플레이션 통계는 틀:인플레이션/KR/데이터셋에, 미국은 틀:인플레이션/US/데이터셋에 있습니다.

사용법

사용시 틀 구조는 다음과 같습니다.

{{인플레이션|country_code|value|start_year}}
{{인플레이션|country_code|value|start_year|end_year}}
{{인플레이션|country_code|value|start_year|r=decimals|fmt=c}}
{{인플레이션|country_code|value|start_year|r=decimals|fmt=eq}}
{{인플레이션|country_code|value|start_year|r=decimals|fmt=eq|cursign=X}}

매개변수

country_code (매개변수 1)은 나라 코드이며, AU, CA, DE, KR, UK, US 등입니다.
value (매개변수 2)는 계산하고 싶은 값입니다. 자리 구분을 넣을 수는 있지만, 통화 기호는 넣을 수 없습니다.
start_year (매개변수 3)은 인플레이션율의 계산의 첫 연도입니다. 어떤 연도를 선택할 수 있을지는 나라마다 다릅니다.
end_year (매개변수 4)는 임의입니다. 수치가 부여되어 있는 경우, 인플레이션율의 계산의 마지막 연도입니다. 어느 연도를 선택할 수 있을지는 나라마다 다르지만, start_year보다는 큰 값이며, 올해보다 앞일 필요가 있습니다. 여기에 값을 넣을 수 없는 경우에는 데이터 표에 있는 마지막 연도의 데이터를 가집니다.
r=decimals는 반올림하는 자리를 나타냅니다. 음수값은 윗 유효 숫자를 올리고, 양수값은 소수 0 자리를 포함하여 자리수를 나타냅니다.
fmt=c 를 부여하면 반환되는 값에 자리 구분이 들어갑니다.
fmt=eq 를 부여하면, ‘에 해당’이라는 글자가 들어갑니다.
cursign=로 통화 기호를 부여할 수 있습니다. 기본값은 $입니다.

국가 코드

각 국가별 하위 틀의 데이터는 해당 통계의 범위를 나타내는 '시작 연도'와 '끝 연도'가 있습니다. 데이터가 매년 갱신될 경우, 항상 최신 연도의 것으로 반영됩니다. 반대로 갱신이 잘 이루어지지 않은 데이터라면 마지막으로 갱신된 연도를 기준으로 출력하게 됩니다.

따라서 각 데이터마다 업데이트가 다를 수 있으므로 끝 연도의 확인이 중요합니다. 또한 올해의 데이터가 없을수도 있으므로 끝 연도에 {{CURRENTYEAR}}를 사용하여서는 안 됩니다.

모든 시작 연도와 끝 연도는 {{인플레이션 년도}}에서 관리되고 있으며, 끝 연도 변수를 입력하지 않을 경우 {{인플레이션 년도}}에 입력된 연도가 자동으로 반영됩니다.

아래는 지원하는 국가코드 표입니다.

코드	국가	시작 연도	끝 연도	데이터셋
AU	호주^[2]	1901	2018	/AU/데이터셋
CA	캐나다^[3]	1914	2024	/CA/데이터셋
DE	독일^[4]	1882	2017	/DE/데이터셋
FR	프랑스^[5]	1901	2020	/FR/데이터셋
KR	대한민국^[6]	1951	2017	/KR/데이터셋
JP	일본^[7]	1946	2022	/JP/데이터셋
SV	스웨덴^[8]	1830	2009	/SV/데이터셋
UK	영국^[9]	1209	2020	/UK/데이터셋
US	미국^[10]	1800	2022	/US/데이터셋

예시

OK {{인플레이션|DE|100|2000}} → 65
OK {{인플레이션|US|595|1982}} → 1596
OK {{인플레이션|US|595|1982|fmt=eq}} → 2022년 기준 $1,596에 해당
OK {{인플레이션|US|800|1942|fmt=eq|r=-3}} → 2022년 기준 $13,000에 해당
OK {{인플레이션|US|100|2010|2012|fmt=eq|r=2}} → 2012년 기준 $105.28에 해당
OK US $595 ({{인플레이션|US|595|1982|fmt=eq}}) → US $595 (2022년 기준 $1,596에 해당)
OK US $595 ({{인플레이션|US|595|1982|fmt=eq|cursign=[[미국 달러|US$]]}}) → US $595 (2022년 기준 US$1,596에 해당)
OK $21 million (equivalent to ${{인플레이션|US|21|2005|r=2}} million in {{인플레이션 년도|US}}) → $21 million (2022년의 $27.83 million에 해당)
아니오 {{인플레이션|UK|1|1323|fmt=eq}} → 2020년 기준 $672에 해당
OK {{인플레이션|UK|1|1323|fmt=eq|cursign=£}} → 2020년 기준 £672에 해당
OK {{인플레이션|AU|100|2025|fmt=eq}} → 2025년 기준 $100에 해당

오류 메시지를 출력시키지 않고 올바르지 않은 방법으로 틀을 사용할 수 있습니다. 틀 설명의 처음에 있는 경고와 적절한 사용을 읽어주세요.

아니오 $100 (오늘날의 ${{인플레이션|US|595|1982|fmt=c}}) → $595 (오늘날의 $1,596)
아니오 $100 ({{CURRENTYEAR}}년의 ${{인플레이션|US|595|1982|fmt=c}}에 해당) → $100 (2025년의 $1,596에 해당)
아니오 $100 (${{인플레이션|US|595|1982|fmt=c}} adjusted for inflation) → $100 ($1,596 adjusted for inflation)
OK $100 ({{인플레이션|US|595|1982|fmt=eq}}) → $100 (2022년 기준 $1,596에 해당)
OK $100 ({{인플레이션 년도|US}}년의 ${{인플레이션|US|595|1982|fmt=c}}에 해당) → $100 (2022년의 $1,596에 해당)
아니오 1975년에 $1억의 자산을 모은 신원미상 여성은 {{인플레이션 년도|US}}년에 m${{인플레이션|US|1|1975|fmt=c}}억의 자산가가 된다. → 1975년에 $1억의 자산을 모은 신원미상의 여성은 2022년에 $5억의 자산가가 된다.
OK 1975년에 신원미상 여성이 모은 $1억은 {{인플레이션 년도|US}}년의 ${{인플레이션|US|1|1975|fmt=c}}억에 해당된다. → 1975년에 신원미상 여성이 모은 $1억은 2022년의 $5억에 해당된다.

무효한 매개변수가 입력되거나 필요한 매개변수가 입력되지 않으면 출력 문서에 오류를 나타내며 분류:인플레이션 틀 오류가 있는 문서로 분류됩니다.

아니오 {{인플레이션}} → {{인플레이션}} 오류: |index= (매개변수 1), |value= (매개변수 2) and |start_year= (매개변수 3)가 지정되지 않음
아니오 {{인플레이션|abc}} → {{인플레이션}} 오류: |value= (매개변수 2) and |start_year= (매개변수 3)가 지정되지 않음
아니오 {{인플레이션|AU}} → {{인플레이션}} 오류: |value= (매개변수 2) and |start_year= (매개변수 3)가 지정되지 않음
아니오 {{인플레이션|AU|100}} → {{인플레이션}} 오류: |start_year= (매개변수 3)가 지정되지 않음
아니오 {{인플레이션|abc|€100|1980}} → {{인플레이션}} 오류: |index=abc(매개변수 1)에 해당되는 인덱스가 없음 (도움말)
아니오 {{인플레이션|DE|€100|1980}} → {{인플레이션}} 오류: NaN, 값이 숫자가 아님 : |value=€100 (매개변수 2)
아니오 {{인플레이션|DE|€100|zzzz|zzzz|r=zzzz}} → {{인플레이션}} 오류: NaN, 값이 숫자가 아님 : |value=€100 (매개변수 2), |start_year=zzzz (매개변수 3), |end_year=zzzz (매개변수 4) 및 |r=zzzz
아니오 {{인플레이션|AU|100|1200|2026}} → {{인플레이션}} 오류: |start_year=1200 (매개변수 3)는 인덱스 "AU"의 사용가능한 시작년도(1901)보다 작은 값 및 |end_year=2026 (매개변수 4)가 인덱스 "AU"의 가장 최근 연도(2018)보다 큼.
아니오 {{인플레이션|AU|100|2005|2004}} → {{인플레이션}} 오류: |start_year=2005 (매개변수 3)이 |end_year=2004 (매개변수 4)보다 큼.
아니오 {{인플레이션|AU|100|2005|2026|fmt=eq}} → {{인플레이션}} 오류: |end_year=2026 (매개변수 4)가 인덱스 "AU"의 가장 최근 연도(2018)보다 큼.
아니오 {{인플레이션|AU|100|2025|2026|fmt=eq}} → {{인플레이션}} 오류: |end_year=2026 (매개변수 4)가 인덱스 "AU"의 가장 최근 연도(2018)보다 큼.
아니오 {{인플레이션|AU|100|2025|1905|fmt=eq}} → {{인플레이션}} 오류: |start_year=2025 (매개변수 3)이 |end_year=1905 (매개변수 4)보다 큼.
아니오 {{인플레이션|AU|100|2026|fmt=eq}} → {{인플레이션}} 오류: |start_year=2026 (매개변수 3)이 인덱스 "AU"의 가장 최근 연도(2018)보다 큼.

힌트

환율

이 틀은 특정 통화간의 환율 계산 기능이 없습니다. 예컨대, 1960년의 1,000.00 독일마르크가 현재의 가치로 어느 정도가 될지 {{인플레이션|DE|1000|1960|r=2}}로 입력해서 계산하려고 해도, 값은 독일마르크(2248.97)로 반환됩니다. 유로로는 변환되지 않습니다.

환전 계산이 필요한 경우에는 수동으로 계산해야만 됩니다. 예를들면, 유로와 독일마르크 사이의 변환율은 € 1 = DM 1.95583입니다.

OK {{#expr:({{인플레이션|DE|1000|1960|r=2}} / 1.95583) round 2}} → 1149.88

수동 계산 뿐만 아니라 자동 계산 틀을 함께 사용한다면 이 문제는 해결됩니다.

수치의 반올림

불필요하게 상세한 수치를 표시하지 않으려면 |r=를 지정하는 것으로 지정한 자리에서 아래의 값을 반올림할 수가 있습니다. 소숫점 이하 두 번째 자리까지가 필요한 경우는 |r=2를 사용합니다. |r=-3로 음수를 넣을 수 있습니다. 이때는 천 단위로 반올림되며, |r=-6은 백만 단위로 반올림됩니다. 이 틀은 데이터베이스에는 1% 정도의 오차가 있기 때문에 불필요하게 자세한 수치를 표시하는 건 권장하지 않습니다.

큰 수치를 취급할 때

반환되는 수치가 너무 클 때, 예를들면, 값은 非"120000000000000"가 아니라 "1.2E+14"처럼 지수로 반환되지만 백과사전 문서로는 전혀 좋아할만한 형태가 아닙니다. 이를 피하기 위해서 몇 번이나 미리보기를 하면서 매개변수를 조정하는 것이 권장됩니다.

OK ${{인플레이션|US|1000000000000|1900|r=-11|fmt=c}} → $31,100,000,000,000
아니오 ${{인플레이션|US|10000000000000|1900|r=-12|fmt=c}} → $311,000,000,000,000
아니오 ${{인플레이션|US|10000000000|1900|r=-9|fmt=c}}천 → $311,000,000,000천
OK ${{인플레이션|US|10000000|1900|r=-6|fmt=c}}백만 → $311,000,000백만
OK ${{인플레이션|US|10000|1900|r=-3|fmt=c}}억 → $311,000억
OK ${{인플레이션|US|10|1900|fmt=c}}조 → $311조

시행착오를 피하기 위해서 다음 문단같은 방법도 있습니다.

Format price 틀의 사용

{{Format price}}는 가격을 나타내기 위해서 만들어진 틀입니다. 예를들면, "953,783,409,856.12" 대신에 "9538억"로 표시됩니다. "1234.5"는 "1,234.50"가 됩니다.

OK ${{Format price|{{인플레이션|US|10000000000000|1900}}}} → $311조
OK ${{Format price|{{인플레이션|US|1000000|1990}}}} → $198만
OK DM {{Format price|{{인플레이션|DE|1000000|1957|1978}}}} → DM 201만
OK £{{Format price|{{인플레이션|UK|1000|1323}}}} → £67.2만

출처 표시

이 틀을 사용할 때, {{Inflation-fn}}를 사용해서 인플레이션율의 출처를 나타내는 것이 권장됩니다. 나라 코드를 설정하면, 하나 또는 두 개의 각주가 생성됩니다. 다음과 같이 사용합니다.

1985년에는 평균 단가가 $1,040이었다. 이는 {{인플레이션|US|1040|1985|fmt{{=}}eq}}}}인 {{Inflation-fn|US}}.

아래와 같이 표시됩니다.

1985년에는 평균 단가가 $1,040이었다. 이는 2022년 기준 $2,503에 해당인 ^[10].

각주는 그 문서에서 가장 가까운 {{reflist}} 또는 <references />로 표시됩니다. 이 문서의 경우에는 아래의 References를 참조할지, 위의 각주 번호를 클릭해주세요.

한계

현황에서는 역산, 즉 현재의 통화가치를 과거의 통화가치로 환산할 수는 없습니다.
Substitution에는 대응하지 않습니다.

개발자를 위해서

인플레이션율의 틀은 아래의 이름으로 작성해주세요.

틀:인플레이션/이름
틀:인플레이션/이름/데이터셋
틀:인플레이션/이름/시작년
틀:인플레이션/설명문서/이름

수치를 수정한 경우에는 아래의 것의 수정도 함께 해주세요.

현재 틀 항목의 하위페이지들:

틀:
인플레이션

틀 토론:
인플레이션

통화단위 및 인플레이션 변환 틀:

같이 보기

참고 문헌

↑ 어느 정도 가까운 연도까지는 매년 1월에 갱신되는 데이터 표가 어떻게 구성되어 있는지에 따릅니다. 데이터 표에 따라서는 12월에 갱신되는 것도 2024도 연중에 갱신되는 것도 2024, 연말에 갱신되는 것도 있습니다2023.
↑ Australian Consumer Price Inflation figures follow the Long Term Linked Series provided in Australian Bureau of Statistics (2011) 6461.0 – Consumer Price Index: Concepts, Sources and Methods, 2011 as explained at §§3.10–3.11; this series comprises "from 1901 to 1914, the A Series Retail Price Index; from 1914 to 1946–47, the C Series Retail Price Index; from 1946-47 to 1948-49, a combination of the C Series Index, excluding rent, and the housing group of the CPI; and from 1948–49 onwards, the CPI." (3.10). Retrieved May 4, 2015
↑ “Inflation Calculator” [인플레이션 계산기]. 《캐나다 은행》 (영어). 2025년 1월 11일에 확인함.
↑ German inflation numbers based on data available from Deutsches Statistisches Bundesamt.
↑ Chiffres de l'inflation en France d'après INSEE. [1], Coefficient de transformation de l'euro ou du franc d'une année, en euro ou en franc d'une autre année. Dernière visite le 05/01/2017
↑ 국가지표체계의 물가 상승률 시계열 조회. 2018년 4월 3일 확인
↑ 일본의 물가상승률은 총무성 통계청 집계를 의함 2022년은 “昭和40年の1万円を、今のお金に換算するとどの位になりますか？” [1965년의 1만 엔을, 오늘날의 돈으로 환산하면 어느 정도가 될까요?]. 《日本銀行》 (일본어). 2023년 3월 4일에 확인함. , 1955년부터 2021년까지는 “長期経済統計　物価” [장기경제통계 물가]. 《内閣府》 (일본어). 2023년 3월 4일에 확인함. , 1946년부터 1954년까지는“昭和戦後史” [쇼와 전후사]. 2023년 3월 4일에 확인함. 에 의함.
↑ Inflation in Sweden, 스웨덴 통계청, 2018년 4월 17일 확인
↑ UK Retail Price Index inflation figures are based on data from Clark, Gregory (2020). “The Annual RPI and Average Earnings for Britain, 1209 to Present (New Series)”. 《MeasuringWorth》. 2021년 8월 8일에 확인함.
↑ ^가 ^나 Federal Reserve Bank of Minneapolis Community Development Project. “Consumer Price Index (estimate) 1800–”. Federal Reserve Bank of Minneapolis. 2018년 4월 3일에 확인함.