Intl.DisplayNames - JavaScript | MDN

Toggle sidebar

Theme

OS default
Light
Dark

한국어

Remember language Learn more

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 2021년 4월.

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

시도해 보기

const regionNamesInEnglish = new Intl.DisplayNames(["en"], { type: "region" });
const regionNamesInTraditionalChinese = new Intl.DisplayNames(["zh-Hant"], {
  type: "region",
});

console.log(regionNamesInEnglish.of("US"));
// Expected output: "United States"

console.log(regionNamesInTraditionalChinese.of("US"));
// Expected output: "美國"

생성자

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를 생성하고, 지역 코드에 대한 표시 이름을 가져옵니다.

js
// 영어로 지역 표시 이름을 가져옵니다.
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를 생성하고, 언어-문자 체계-지역 시퀀스의 표시 이름을 가져옵니다.

js
// 영어로 언어 표시 이름을 가져옵니다.
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를 생성하고 문자 코드의 표시 이름을 가져옵니다.

js
// 영어로 문자 체계 표시 이름을 가져옵니다.
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를 생성하고 통화 코드의 표시 이름을 가져옵니다.

js
// 영어로 통화 코드의 이름을 가져옵니다.
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® 2027 Internationalization API Specification
# intl-displaynames-objects

브라우저 호환성

Enable JavaScript to view this browser compatibility table.

같이 보기

Intl

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 2025년 2월 11일 by MDN contributors.

View this page on GitHub • Report a problem with this content

표준 내장 객체
Intl.DisplayNames
생성자
1. Intl.DisplayNames() 생성자
정적 메서드
1. Intl.DisplayNames.supportedLocalesOf()
인스턴스 메서드
1. of()
2. resolvedOptions()
상속
Object/Function
정적 메서드
1. Function.prototype.apply()
2. Function.prototype.bind()
3. Function.prototype.call()
4. Function.prototype.toSource()
5. Function.prototype[@@hasInstance]()
정적 속성
1. Function: displayName
2. Function.prototype.length
3. Function: name
4. Function
5. Function.arguments
6. Function.prototype.caller
인스턴스 메서드
1. Object.prototype.__defineGetter__()
2. Object.prototype.__defineSetter__()
3. Object.prototype.__lookupGetter__()
4. Object.prototype.__lookupSetter__()
5. Object.prototype.hasOwnProperty()
6. Object.prototype.isPrototypeOf()
7. Object.prototype.propertyIsEnumerable()
8. Object.prototype.toLocaleString()
9. Object.prototype.toString()
10. Object.prototype.valueOf()
인스턴스 속성
1. Object.prototype.__proto__
2. Object.prototype.constructor
관련 페이지
Intl
Intl.Collator
Intl.DateTimeFormat
Intl.DurationFormat
Intl.ListFormat
Intl.Locale
Intl.NumberFormat
Intl.PluralRules
Intl.RelativeTimeFormat
Intl.Segmenter

Intl.DisplayNames

In this article

Help improve MDN