틀:인플레이션/설명문서

링크 추가
위키백과, 우리 모두의 백과사전.

이 틀에서는 국가의 약칭, 예를들면 미국이면 "US", 영국이면 "UK"와 start_year (시작 연도)를 입력하면 그 연도로부터 최근 연도까지의 소비자 물가지수의 인플레이션율을 반환합니다[1]. 예를들면, 미국이면 인플레이션율의 데이터는 틀:인플레이션/US/데이터셋이라는 이름의 하위 틀에 있습니다. 즉, 하위 틀의 데이터가 매년 갱신되어 있으면, 이 틀을 호출하고 있는 문서의 인플레이션율은 항상 최신의 것과, 지정한 연도 사이의 것이 됩니다.

end_year (끝 연도)를 지정하는 것으로, 두 연도 사이의 인플레이션률을 계산할 수도 있습니다.

사용법[편집]

{{인플레이션|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}}

아래는 이 인플레이션 틀에서 지원하는 국가코드 표입니다. :

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

매개변수 설명[편집]

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

예시[편집]

  • 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|2024|fmt=eq}} → 2024년 기준 $100에 해당

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

  • 아니오아니오 $100 (오늘날의 ${{인플레이션|US|595|1982|fmt=c}}) → $595 (오늘날의 $1,596)
  • 아니오아니오 $100 ({{CURRENTYEAR}}년의 ${{인플레이션|US|595|1982|fmt=c}}에 해당) → $100 (2024년의 $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|2025}} → {{인플레이션}} 오류: |start_year=1200 (매개변수 3)는 인덱스 "AU"의 사용가능한 시작년도(1901)보다 작은 값 및 |end_year=2025 (매개변수 4)가 인덱스 "AU"의 가장 최근 연도(2018)보다 큼.
  • 아니오아니오 {{인플레이션|AU|100|2005|2004}} → {{인플레이션}} 오류: |start_year=2005 (매개변수 3)이 |end_year=2004 (매개변수 4)보다 큼.
  • 아니오아니오 {{인플레이션|AU|100|2005|2025|fmt=eq}} → {{인플레이션}} 오류: |end_year=2025 (매개변수 4)가 인덱스 "AU"의 가장 최근 연도(2018)보다 큼.
  • 아니오아니오 {{인플레이션|AU|100|2024|2025|fmt=eq}} → {{인플레이션}} 오류: |end_year=2025 (매개변수 4)가 인덱스 "AU"의 가장 최근 연도(2018)보다 큼.
  • 아니오아니오 {{인플레이션|AU|100|2024|1905|fmt=eq}} → {{인플레이션}} 오류: |start_year=2024 (매개변수 3)이 |end_year=1905 (매개변수 4)보다 큼.
  • 아니오아니오 {{인플레이션|AU|100|2025|fmt=eq}} → {{인플레이션}} 오류: |start_year=2025 (매개변수 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를 참조할지, 위의 각주 번호를 클릭해주세요.

한계[편집]

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

개발자를 위해서[편집]

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

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

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

'인플레이션' 이름을 가진 '틀' 과 '틀 토론' 네임스페이스 페이지들:

틀:
인플레이션
틀 토론:
인플레이션

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

같이 보기[편집]

참고 문헌[편집]

  1. ↑ 어느 정도 가까운 연도까지는 매년 1월에 갱신되는 데이터 표가 어떻게 구성되어 있는지에 따릅니다. 데이터 표에 따라서는 12월에 갱신되는 것도 2023도 연중에 갱신되는 것도 2023, 연말에 갱신되는 것도 있습니다2022.
  2. ↑ 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
  3. ↑ “Inflation Calculator” [인플레이션 계산기]. 《캐나다 은행》 (영어). 2021년 5월 5일에 확인함. 
  4. ↑ German inflation numbers based on data available from Deutsches Statistisches Bundesamt.
  5. ↑ 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
  6. ↑ 국가지표체계의 물가 상승률 시계열 조회. 2018년 4월 3일 확인
  7. ↑ 일본의 물가상승률은 총무성 통계청 집계를 의함 2022년은 “昭和40年の1万円を、今のお金に換算するとどの位になりますか？” [1965년의 1만 엔을, 오늘날의 돈으로 환산하면 어느 정도가 될까요?]. 《日本銀行》 (일본어). 2023년 3월 4일에 확인함. , 1955년부터 2021년까지는 “長期経済統計　物価” [장기경제통계 물가]. 《内閣府》 (일본어). 2023년 3월 4일에 확인함. , 1946년부터 1954년까지는“昭和戦後史” [쇼와 전후사]. 2023년 3월 4일에 확인함. 에 의함.
  8. ↑ Inflation in Sweden, 스웨덴 통계청, 2018년 4월 17일 확인
  9. ↑ 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일에 확인함. 
  10. ↑ 가 나 Federal Reserve Bank of Minneapolis Community Development Project. “Consumer Price Index (estimate) 1800–”. Federal Reserve Bank of Minneapolis. 2018년 4월 3일에 확인함. 


원본 주소 "https://ko.wikipedia.org/w/index.php?title=틀:인플레이션/설명문서&oldid=35731270"