toLocalString()

1. toLocaleString()

number.toLocaleString([locales[, options]])

 

매개변수

• locales(선택) : 사용한 로케일을 지정하는 문자열이나 문자열 배열이다. (예: en-US, ko-KR)
• options(선택) : 포맷 옵션을 설정하는 객체이다.

const number = 1234567.89;

// 기본 사용
console.log(number.toLocaleString()); 
// 예: "1,234,567.89" (브라우저 설정에 따라 다름)

// 특정 로케일 사용
console.log(number.toLocaleString('ko-KR')); 
// "1,234,567.89" -> 한국어 로케일

// 옵션 추가 (통화)
console.log(number.toLocaleString('ko-KR', { style: 'currency', currency: 'KRW' })); 
// "₩1,234,567"

// 옵션 추가 (소수점 조절)
console.log(number.toLocaleString('en-US', { minimumFractionDigits: 3, maximumFractionDigits: 3 })); 
// "1,234,567.890"

 

1-1. 날짜(Date)에서 사용

toLocaleString은 Date 객체의 날짜와 시간을 로케일에 맞게 문자열을 변환한다.

date.toLocaleString([locales[, options]])

 

매개변수

• locales(선택) : 사용한 로케일을 지정하는 문자열이나 문자열 배열이다. (예: en-US, ko-KR)
• options(선택) : 날짜 및 시간 형식을 설정하는 객체이다.

const date = new Date();

// 기본 사용
console.log(date.toLocaleString()); 
// 예: "11/24/2024, 10:00:00 AM" (브라우저 로케일에 따라 다름)

// 특정 로케일 사용
console.log(date.toLocaleString('ko-KR')); 
// "2024. 11. 24. 오전 10:00:00"

// 옵션 추가 (날짜만)
console.log(date.toLocaleString('en-US', { year: 'numeric', month: 'long', day: 'numeric' })); 
// "November 24, 2024"

// 옵션 추가 (시간만)
console.log(date.toLocaleString('ko-KR', { hour: '2-digit', minute: '2-digit', second: '2-digit' })); 
// "오전 10:00:00"

 

1-2. 옵션 상세

숫자와 날짜 모두에서 사용할 수 있는 옵션들

 

숫자 관련 옵션

• style : 포맷 스타일(devical, currency, percent)
• currency : 통화 단위(USD, KRW, EUR 등)
• minimumFractionDigits, maximumFractionDigits: 소수점 자리수 조절
• useGrouping : 천 단위 구분 기호 사용 여부(true 또는 false)

날짜 및 시간 관련 옵션

• 날짜 : year, month, day, weekday(형식: numeric, 2-digit, long, short, narrow)
• 시간 : hour, minute, second, hour12(12시간제 사용 여부)

 

2. 장점

• 지역화된 포맷을 쉽게 구분 가능
• 통화, 날짜, 시간 포맷 옵션이 다양하고 유연
• 브라우저에서 자동으로 로케일에 맞는 형식을 처리