object.toLocaleString([locales[, options]]);
숫자, 날짜, 배열 등의 객체를 사용자의 로컬 설정에 맞는 문자열 형식으로 변환
주요 사용 대상
- 숫자(Number): 숫자를 지역별 형식(예: 천 단위 구분 기호, 소수점)으로 변환.
- 날짜(Date): 날짜와 시간을 지역별 형식으로 변환.
이들의 배열을 넣으면 한번에 변환!
2. 매개변수
1.
locales
(선택):⇒ BCP 47 언어 태그 문자열(예:
"en-US"
, "ko-KR"
) 또는 태그 배열.- 생략하면 브라우저의 기본 로케일을 사용
2.
options
(선택): ⇒ 숫자나 날짜의 형식을 세부적으로 지정하는 옵션 객체.
- 숫자:
style
,currency
,minimumFractionDigits
등.
- 날짜:
weekday
,year
,month
,day
,hour
,minute
,second
등.
3. 사용 예제
- 숫자
const number = 1234567.89; // 한국 로케일 console.log(number.toLocaleString('ko-KR')); // "1,234,567.89" // 독일 로케일 console.log(number.toLocaleString('de-DE')); // "1.234.567,89" // 통화 형식 지정 console.log(number.toLocaleString('en-US', { style: 'currency', currency: 'KRW' })); // "₩1,234,567.89"
- 날짜
const date = new Date('2024-12-28T07:00:00'); // 한국 로케일 console.log(date.toLocaleString('ko-KR')); // "2024. 12. 28. 오전 7:00:00" // 미국 로케일 console.log(date.toLocaleString('en-US',{hour: '2-digit', minute: '2-digit' })); // "12/28/2024, 07:00:00 AM" // 옵션 추가 console.log(date.toLocaleString('en-GB', { weekday: 'long', year: 'numeric', month: 'long', day: 'numeric' })); // "Saturday, 28 December 2024"