JavaScript Number toLocaleString() 메서드

정의와 사용법

toLocaleString() 로컬 언어 형식을 사용하여 숫자를 문자열로 반환합니다。

언어 형식은 컴퓨터의 로케일 설정에 따라 결정됩니다。

예제

예제 1

로케일 설정을 사용하여 숫자를 문자열로 형식화합니다：

let num = 1000000;
let text = num.toLocaleString();

직접 시험해 보세요

예제 2

芬란드의 특정 언어 환경을 사용하여 숫자를 문자열로 형식화합니다：

let num = 1000000;
let text = num.toLocaleString("fi-FI");

직접 시험해 보세요

예제 3

미국의 특정 언어 환경을 사용하여 숫자를 화폐 문자열로 형식화합니다：

let num = 1000000;
let text = num.toLocaleString("en-US", {style:"currency", currency:"USD"});

직접 시험해 보세요

예제 4

사용 options 파라미터(객체)로 통화 포맷화:

let num = new Number(1000000);
const myObj = {
  style: "currency",
  currency: "EUR"
}
let text = num.toLocaleString("en-GB", myObj);

직접 시험해 보세요

예제 5

let num = new Number(1000000);
let text = num.toLocaleString("en-GB", {style:"currency", currency:"EUR"});

직접 시험해 보세요

예제 6

JAPAN의 특정 언어 환경 사용:

let num = 1000000;
let text = num.toLocaleString("ja-JP", {style:"currency", currency:"JPY"});

직접 시험해 보세요

문법

number.toLocaleString(locales, options)

파라미터

파라미터 설명
locales 선택 사항. 사용할 언어별 형식. 다음 표를 참조하십시오.
options 선택 사항. 형식 옵션을 가진 객체. 다음 표를 참조하십시오.

locales 가능한 값:

  • ar-SA 아라비어(사우디 아라비아)
  • bn-BD 뱅갈라어(방글라데시)
  • bn-IN 뱅갈라어(인도)
  • cs-CZ 체코어(체코 공화국)
  • da-DK 덴마크어(덴마크)
  • de-AT 오스트리아 독일어
  • de-CH 스위스 독일어
  • de-DE 표준 독일어(독일에서 사용)
  • el-GR 현대 그리스어
  • en-AU 오스트레일리아 영어
  • en-CA 캐나다 영어
  • en-GB 영국 영어
  • en-IE 아일랜드 영어
  • en-IN 인도 영어
  • en-NZ 뉴질랜드 영어
  • en-US 미국 영어
  • en-ZA 영어(남아프리카)
  • es-AR 아르헨티나 스페인어
  • es-CL 칠레 스페인어
  • es-CO 콜롬비아 스페인어
  • es-ES 카스티야 스페인어(스페인 중북부에서 사용)
  • es-MX 메xic오 스페인어
  • es-US 미국 스페인어
  • fi-FI 芬란어(芬란)
  • fr-BE 벨기에 프랑스어
  • fr-CA 캐나다 프랑스어
  • fr-CH 스위스 프랑스어
  • fr-FR 표준 프랑스어(특히 프랑스에서)
  • he-IL 히브리어(이스라엘)
  • hi-IN 인도어(인도)
  • hu-HU 헝가리어(헝가리)
  • id-ID 인도네시아어(인도네시아)
  • it-CH “스위스” 이탈리아어
  • it-IT 표준 이탈리아어(이탈리아에서 사용)
  • ja-JP 일어(일본)
  • ko-KR 한어(대한민국)
  • nl-BE 벨기에 네덜란드어
  • nl-NL 표준 네덜란드어(네덜란드어)
  • no-NO 노르웨이어(노르웨이)
  • pl-PL 폴란드어(폴란드)
  • pt-BR 브라질 포르투갈어
  • pt-PT 유럽 포르투갈어(포르투갈어 서면과 발화)
  • ro-RO 루마니아어(루마니아)
  • ru-RU 러시아어(러시아 연방)
  • sk-SK 스로바키아어(스로바키아)
  • sv-SE 스웨덴어(스웨덴)
  • ta-IN 인도 타米尔어
  • ta-LK 스리랑카 타米尔어
  • th-TH 타이어(태국)
  • tr-TR 터키어(튀르키예)
  • zh-CN 중국 대륙, 간체자
  • zh-HK 홍콩, 복체자
  • zh-TW 타이완, 복체자

options 파라미터가 받을 수 있는 옵션:

옵션 값
currency 합법 값: 어떤 통화 코드(예 "EUR", "USD", "INR" 등)
currencyDisplay

합법 값:

  • "symbol"(기본)
  • "code"
  • "name"
localeMatcher

합법 값:

  • "best-fit"(기본)
  • "lookup"
maximumFractionDigits 0에서 20까지의 숫자(기본值为 3)
maximumSignificantDigits 1에서 21까지의 숫자(기본值为 21)
minimumFractionDigits 0에서 20까지의 숫자(기본值为 3)
minimumIntegerDigits 1에서 21까지의 숫자(기본值为 1)
minimumSignificantDigits 1에서 21까지의 숫자(기본值为 21)
style

합법 값:

  • "currency"
  • "decimal"(기본)
  • "percent"
useGrouping

합법 값:

  • "true"(기본)
  • "false"

반환 값

타입 설명
문자열 지역 포맷 숫자 문자열을 표시합니다.

기술 세부 사항

반환 값

숫자의 문자열 표현은 구현에 따라 결정되며, 지역 규범에 따라 포맷되며, 소수점이나 천원 구분 기호에 사용되는 점표기 기호에 영향을 미칠 수 있습니다.

발생시킵니다

예외 설명
TypeError 이 메서드를 호출하는 객체가 Number가 아니면 예외를 발생시킵니다.

브라우저 지원

toLocaleString() ES3 (ES3) 기능입니다.

모든 브라우저가 완전히 ES3 (JavaScript 1999)을 지원합니다：

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
지원 지원 지원 지원 지원 지원