Intl.DisplayNames

Intl.DisplayNames 객체를 사용하면 언어, 지역 그리고 문자 체계 표시 이름을 일관되게 번역할 수 있습니다.

시도해보기

생성자

Intl.DisplayNames() (en-US): 새 Intl.DisplayNames 객체를 생성합니다.

정적 메서드

Intl.DisplayNames.supportedLocalesOf() (en-US): 런타임의 기본 로케일로 대체되지 않고, 제공된 로케일 중 지원되는 로케일을 포함한 배열을 반환합니다.

인스턴스 속성

이 속성은 Intl.DisplayNames.prototype에서 정의되며 모든 Intl.DisplayNames 인스턴스에서 공유됩니다.

Intl.DisplayNames.prototype.constructor: 인스턴스 객체를 만든 생성자 함수입니다. Intl.DisplayNames 인스턴스의 경우 초기 값은 Intl.DisplayNames (en-US) 생성자입니다.
Intl.DisplayNames.prototype[@@toStringTag]: @@toStringTag 속성의 초기 값은 문자열 "Intl.DisplayNames"입니다. 이 속성은 Object.prototype.toString()에서 사용됩니다.

인스턴스 메서드

Intl.DisplayNames.prototype.of() (en-US): 이 메서드는 code를 받고 Intl.DisplayNames 인스턴스를 만들때 제공받은 로케일과 옵션에 따라 문자열을 반환합니다.
Intl.DisplayNames.prototype.resolvedOptions() (en-US): 객체 초기화 중에 계산된 로케일과 서식 옵션을 반영한 속성이 있는 새 객체를 반환합니다.

예제

지역 코드 표시 이름

로케일에 대한 Intl.DisplayNames를 생성하고, 지역 코드에 대한 표시 이름을 가져옵니다.

// 영어로 지역 표시 이름을 가져옵니다.
let regionNames = new Intl.DisplayNames(["en"], { type: "region" });
regionNames.of("419"); // "Latin America"
regionNames.of("BZ"); // "Belize"
regionNames.of("US"); // "United States"
regionNames.of("BA"); // "Bosnia & Herzegovina"
regionNames.of("MM"); // "Myanmar (Burma)"

// 한국어로 지역 표시 이름을 가져옵니다.
regionNames = new Intl.DisplayNames(["ko"], { type: "region" });
regionNames.of("419"); // "라틴 아메리카"
regionNames.of("BZ"); // "벨리즈"
regionNames.of("US"); // "미국"
regionNames.of("BA"); // "보스니아 헤르체고비나"
regionNames.of("MM"); // "미얀마"

언어 표시 이름

로케일에 대한 Intl.DisplayNames를 생성하고, 언어-문자 체계-지역 시퀀스의 표시 이름을 가져옵니다.

// 영어로 언어 표시 이름을 가져옵니다.
let languageNames = new Intl.DisplayNames(["en"], { type: "language" });
languageNames.of("fr"); // "French"
languageNames.of("de"); // "German"
languageNames.of("fr-CA"); // "Canadian French"
languageNames.of("ko"); // "Traditional Chinese"
languageNames.of("en-US"); // "American English"
languageNames.of("zh-TW"); // "Chinese (Taiwan)"]

// 한국어로 언어 표시 이름을 가져옵니다.
languageNames = new Intl.DisplayNames(["ko"], { type: "language" });
languageNames.of("fr"); // "프랑스어"
languageNames.of("zh"); // "중국어"
languageNames.of("de"); // "독일어"

문자 코드 표시 이름

로케일에 대한 Intl.DisplayNames를 생성하고 문자 코드의 표시 이름을 가져옵니다.

// 영어로 문자 체계 표시 이름을 가져옵니다.
let scriptNames = new Intl.DisplayNames(["en"], { type: "script" });
// Get script names
scriptNames.of("Latn"); // "Latin"
scriptNames.of("Arab"); // "Arabic"
scriptNames.of("Kana"); // "Katakana"

// 한국어로 문자 체계 이름을 가져옵니다.
scriptNames = new Intl.DisplayNames(["ko"], { type: "script" });
scriptNames.of("Latn"); // "로마자"
scriptNames.of("Arab"); // "아랍 문자"
scriptNames.of("Kana"); // "가타카나"

통화 코드 표시 이름

로케일에 대한 Intl.DisplayNames를 생성하고 통화 코드의 표시 이름을 가져옵니다.

// 영어로 통화 코드의 이름을 가져옵니다.
let currencyNames = new Intl.DisplayNames(["en"], { type: "currency" });
// 통화 이름 가져오기
currencyNames.of("USD"); // "US Dollar"
currencyNames.of("EUR"); // "Euro"
currencyNames.of("TWD"); // "New Taiwan Dollar"
currencyNames.of("CNY"); // "Chinese Yuan"

// 한국어로 통화 코드의 이름을 가져옵니다.
currencyNames = new Intl.DisplayNames(["ko"], { type: "currency" });
currencyNames.of("USD"); // "미국 달러"
currencyNames.of("EUR"); // "유로"
currencyNames.of("TWD"); // "신 타이완 달러"
currencyNames.of("CNY"); // "중국 위안화"

명세서

Specification
ECMAScript Internationalization API Specification # intl-displaynames-objects

브라우저 호환성

BCD tables only load in the browser

같이 보기

Intl (en-US)