로케일 코드 (Locale code) - 특정 언어 및 지역을 나타내는 표준

'en-US'와 같은 로케일 코드는 IETF BCP 47 언어 태그를 따릅니다.

https://en.wikipedia.org/wiki/IETF_language_tag

IETF language tag - Wikipedia

---

전체 로케일 코드 조회 방법

모든 로케일 코드를 확인하려면 IANA 언어 하위 태그 등록소에서 확인하거나 Intl 객체의 기능을 활용할 수 있습니다.

예: 브라우저에서 지원하는 로케일 코드 확인

console.log(Intl.DateTimeFormat.supportedLocalesOf(['en-US', 'ko-KR', 'ja-JP', 'es-ES']));

위 코드는 현재 실행 중인 환경에서 지원하는 로케일을 반환합니다.

---

 

언어 코드 : 2자리 또는 3자리 ISO 639-1/639-2 코드 (예: en → 영어, ko → 한국어).

https://ko.wikipedia.org/wiki/ISO_639-1_%EC%BD%94%EB%93%9C_%EB%AA%A9%EB%A1%9D

ISO 639-1 코드 목록 - 위키백과, 우리 모두의 백과사전

로케일 코드 예시

영어

• en-US: 미국 영어
• en-GB: 영국 영어
• en-CA: 캐나다 영어
• en-AU: 호주 영어
• en-IN: 인도 영어

한국어

• ko-KR: 한국어 (대한민국)

---

 

지역/국가 코드 : 2자리 ISO 3166-1 alpha-2 코드 (예: US → 미국, KR → 대한민국).

https://ko.wikipedia.org/wiki/ISO_3166-1_alpha-2#VI

ISO 3166-1 alpha-2 - 위키백과, 우리 모두의 백과사전

 

스크립트 코드 : 4자리 ISO 15924 코드 (예: Latn → 라틴 문자, Cyrl → 키릴 문자).

https://ko.wikipedia.org/wiki/ISO_15924_%EB%B6%80%ED%98%B8_%EB%AA%A9%EB%A1%9D

ISO 15924 부호 목록 - 위키백과, 우리 모두의 백과사전

---

Unicode 확장 :

-u-로 시작하는 확장은 Unicode 확장으로, 특정 로케일에 대한 사용자 선호 사항(예: 달력, 숫자 시스템, 시간대)을 나타냅니다. 

주요 Unicode 확장 키와 값

1. 달력 (Calendar): -u-ca-

• 설명: 날짜를 표시할 때 사용할 달력을 지정합니다.
• 예: -u-ca-japanese (일본식 달력), -u-ca-islamic (이슬람 달력)

사용 가능한 달력 목록:

• gregory: 그레고리력 (기본값)
• buddhist: 태국 불교력
• chinese: 중국 음력
• coptic: 콥트력
• dangi: 단기력 (한국 전통)
• ethiopic: 에티오피아력
• hebrew: 히브리력
• indian: 인도국립력
• islamic: 이슬람력
• islamic-civil: 이슬람 민간력
• japanese: 일본식 연호 달력
• persian: 페르시아력
• roc: 중화민국력 (대만)

---

2. 숫자 체계 (Numbering System): -u-nu-

• 설명: 숫자를 표시할 때 사용할 숫자 체계를 지정합니다.
• 예: -u-nu-arab (아랍 숫자), -u-nu-latn (라틴 숫자)

사용 가능한 숫자 체계 목록:

• latn: 라틴 숫자 (기본값, 0–9)
• arab: 아랍 숫자 (٠–٩)
• arabext: 확장 아랍 숫자
• beng: 벵골어 숫자
• deva: 데바나가리 숫자 (힌두/산스크리트 숫자)
• thai: 태국 숫자
• khmr: 크메르 숫자
• fullwide: 전각 숫자 (０–９)
• mong: 몽골어 숫자
• taml: 타밀 숫자

---

3. 시간대 (Timezone): -u-tz-

• 설명: 특정 시간대를 지정합니다.
• 예: -u-tz-usnyc (미국 뉴욕 시간)

사용 가능한 시간대 코드의 예:

• utc: 협정 세계시
• usnyc: 미국 뉴욕 시간
• europeparis: 유럽 파리 시간
• asiatokyo: 아시아 도쿄 시간

  ---

 

4. 첫째 요일 (First Day of the Week): -u-fw-

• 설명: 주의 첫째 요일을 지정합니다.
• 예: -u-fw-mon (월요일 시작), -u-fw-sun (일요일 시작)

사용 가능한 옵션:

• mon: 월요일 시작
• sun: 일요일 시작
• sat: 토요일 시작

---

 

5. 시간 표시 형식 (Hour Cycle): -u-hc-

• 설명: 시간 표시 형식을 지정합니다.
• 예: -u-hc-h12 (12시간 형식), -u-hc-h24 (24시간 형식)

사용 가능한 옵션:

• h12: 12시간 형식 (오전/오후)
• h23: 24시간 형식 (0–23)
• h24: 24시간 형식 (1–24)
• h11: 12시간 형식 (0–11)

  ---

 

6. 기타 키

• 주목할 만한 확장 키와 예:
  • -u-co-: 정렬 순서 (예: -u-co-phonebk → 전화번호부 스타일)
  • -u-kf-: 숫자 정렬 방식 (예: -u-kf-lower → 소문자 우선 정렬)
  • -u-ss-: 초 단위 시스템 (예: -u-ss-standard → 표준 초 시스템)

---

 

예제 사용

// 일본식 달력 사용
const date = new Intl.DateTimeFormat('ja-JP-u-ca-japanese').format(new Date());
console.log(date); // 예: '令和5年1月11日'

// 태국 숫자 사용
const number = new Intl.NumberFormat('th-TH-u-nu-thai').format(123456789);
console.log(number); // 예: '๑๒๓๔๕๖๗๘๙'