Intl.Locale
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2020.
Intl.Locale
객체는 유니코드 로케일 식별자를 나타내는 Intl 객체의 표준 내장 속성입니다.
시도해보기
설명
Intl.Locale
객체는 유니코드 로케일을 더 쉽게 조작할 수 있도록 하기 위해 탄생했습니다. 유니코드는 "로케일 식별자"라는 문자열로 로케일을 나타냅니다. 로케일 식별자는 "언어 식별자"와 "확장 태그"로 구성됩니다. 언어 식별자는 로케일의 핵심으로 언어, 스크립트 및 지역 하위 태그로 구성됩니다. 로케일에 대한 추가 정보는 선택 사항인 확장 태그에 저장됩니다. 확장 태그에는 달력 유형, 시계 유형, 숫자 체계 유형과 같은 로케일 측면에 대한 정보가 저장됩니다.
전통적으로 Intl API는 유니코드와 마찬가지로 문자열을 사용하여 로케일을 표현했습니다. 이는 간단하고 가벼운 솔루션으로 잘 작동합니다. 하지만 로케일 클래스를 추가하면 언어, 스크립트, 지역, 확장 태그의 구문 분석 및 조작이 더 쉬워집니다. Intl.Locale
의 다음 속성은 유니코드 로케일 식별자 하위 태그에 해당합니다.
하위 태그와 | 대응되는 속성 |
---|---|
language |
language (첫 번째 부분) |
script |
script (두 번째 부분) |
region |
region (두 번째/세번째 부분) |
calendar |
ca (확장) |
caseFirst |
kf (확장) |
collation |
co (확장) |
hourCycle |
hc (확장) |
numberingSystem |
nu (확장) |
numeric |
kn (확장) |
위 정보는 외부 데이터베이스를 참조하지 않고 Locale
객체가 생성될 때 그대로 제공됩니다. Intl.Locale
객체는 사용 가능한 달력, 정렬 방식(collations) 및 숫자 체계와 같은 로케일의 실제 정보에 대한 정보를 반환하는 몇 가지 메서드를 추가로 제공합니다.
생성자
Intl.Locale()
-
새로운
Locale
객체를 생성합니다.
인스턴스 속성
아래 속성은 Intl.Locale.prototype
에 정의되어 있으며 모든 Intl.Locale
객체가 이를 공유합니다.
Intl.Locale.prototype.baseName
-
전체 데이터 문자열의 하위 문자열 형태로
Locale
에 대한 기본 핵심 정보를 반환합니다. Intl.Locale.prototype.calendar
-
로케일의 달력 시대를 가리키는
Locale
의 부분을 반환합니다. Intl.Locale.prototype.caseFirst
-
로케일의 데이터 정렬 규칙에 대/소문자를 고려할지 여부를 반환합니다.
Intl.Locale.prototype.collation
-
로케일의 규칙에 따라 문자열을 정렬하는 데 사용되는
Locale
에 대한 콜레이션 타입을 반환합니다. Intl.Locale.prototype.constructor
-
인스턴스 객체를 생성한 생성자 함수입니다.
Intl.Locale
인스턴스의 경우 초기 값은Intl.Locale
생성자입니다. Intl.Locale.prototype.hourCycle
-
로케일에서 사용하는 시간 유지 형식 규칙을 반환합니다.
Intl.Locale.prototype.language
-
로케일과 연관된 언어를 반환합니다.
Intl.Locale.prototype.numberingSystem
-
로케일에서 사용하는 숫자 체계를 반환합니다.
Intl.Locale.prototype.numeric
-
로케일에 숫자 문자에 대한 특수 콜레이션 처리 기능이 있는지 여부를 반환합니다.
Intl.Locale.prototype.region
-
로케일과 관련된 세상의 지역(보통 국가)를 반환합니다.
Intl.Locale.prototype.script
-
로케일에서 사용되는 특정 언어를 작성하기 위해 사용되는 스크립트를 반환합니다.
Intl.Locale.prototype[@@toStringTag]
-
@@toStringTag
속성의 초기값은 문자열"Intl.Locale"
입니다. 이 속성은Object.prototype.toString()
에서 사용합니다..
인스턴스 메서드
Intl.Locale.prototype.getCalendars()
-
로케일 규칙에 따라 이용 가능한 달력 식별자 배열을 반환합니다.
Intl.Locale.prototype.getCollations()
-
Locale
에 대한 데이터 정렬 유형의Array
을 반환합니다. Intl.Locale.prototype.getHourCycles()
-
12시간 시계("h12"), 일본식 12시간 시계("h11"), 24시간 시계("h23") 또는 사용되지 않는 형식 "h24"를 나타내는 시간 주기 식별자의
Array
를 반환합니다. Intl.Locale.prototype.getNumberingSystems()
-
로케일의 규칙에 따른 가능한 숫자 체계 식별자의
Array
를 반환합니다. Intl.Locale.prototype.getTextInfo()
-
문자
ltr
(왼쪽에서 오른쪽) 또는rtl
(오른쪽에서 왼쪽)의 순서를 나타내는 부분을 반환합니다. Intl.Locale.prototype.getTimeZones()
-
Locale
과 연관된 시간대 식별자의Array
을 반환합니다. Intl.Locale.prototype.getWeekInfo()
-
로케일 규칙에 따라 UTS 35's Week Elements를 반환합니다.
Intl.Locale.prototype.maximize()
-
기존 값을 기반으로 로케일의 언어, 스크립트 및 지역에 대해 가장 가능성이 높은 값을 가져옵니다.
Intl.Locale.prototype.minimize()
-
maximize()
을 호출하여 추가될 로케일에 대한 정보 제거를 시도합니다. Intl.Locale.prototype.toString()
-
Locale의 완전한 로케일 식별자 문자열을 반환합니다.
예제
기본적인 사용법
가장 간단한 방법으로는 Intl.Locale()
생성자가 로케일 식별자를 인수로 받습니다.
const us = new Intl.Locale("en-US");
options 객체와 함께 Locale 생성자를 사용
생성자는 또한 선택적으로 구성 객체 인수를 받을 수 있으며, 이 객체에는 여러 확장 유형 중의 하나가 포함될 수 있습니다. 예를 들어, 구성 객체의 hourCycle
속성을 원하는 시간 주기 유형으로 설정한 다음 생성자에 전달합니다.
const us12hour = new Intl.Locale("en-US", { hourCycle: "h12" });
console.log(us12hour.hourCycle); // Prints "h12"
명세서
Specification |
---|
ECMAScript Internationalization API Specification # locale-objects |
브라우저 호환성
BCD tables only load in the browser
같이 보기
- Polyfill of
Intl.Locale
in FormatJS Intl
- 정규 유니코드 로케일 식별자 in the Unicode locale data markup language spec