Intl.DisplayNames

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.

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

시도해보기

생성자

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

정적 메서드

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

인스턴스 속성

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

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

인스턴스 메서드

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

예제

지역 코드 표시 이름

로케일에 대한 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