Intl.DateTimeFormat.supportedLocalesOf()

Baseline Widely available

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

Intl.DateTimeFormat.supportedLocalesOf() 정적 메서드는 런타임의 기본 로케일로 돌아갈 필요 없이 날짜 및 시간 서식 지정에서 지원되는 제공된 로케일을 포함하는 배열을 반환합니다.

시도해보기

구문

js
Intl.DateTimeFormat.supportedLocalesOf(locales)
Intl.DateTimeFormat.supportedLocalesOf(locales, options)

매개변수

locales

BCP 47 언어 태그가 포함된 문자열 또는 이러한 로케일 식별자의 배열입니다. locales 인수의 일반적인 형식과 해석에 대해서는 Intl 메인 페이지의 매개변수 설명을 참조하세요.

options Optional

다음의 속성을 가질 수 있는 객체

localeMatcher

사용할 로케일 일치 알고리즘입니다. 가능한 값은 "lookup""best fit"이며, 기본값은 "best fit"입니다. 이 옵션에 대해 더 알고 싶으시다면 Intl 페이지를 참고하시기 바랍니다.

반환 값

런타임의 기본 로케일로 되돌아가지 않고 상대 시간 형식으로 지원되는 지정된 로케일 태그의 하위 집합을 나타내는 문자열 배열입니다.

예제

supportedLocalesOf() 사용하기

인도네시아어와 독일어는 지원하지만 날짜 및 시간 서식에서 인도네시아어는 지원하지 않는 런타임을 가정하면 supportedLocalesOf는 인도네시아어와 독일어 언어 태그를 변경하지 않고 반환하지만 pinyin 콜레이션은 날짜 및 시간 서식과 관련이 없거나 인도네시아어에서 사용되며 인도네시아에 특화된 독일어는 지원되지 않을 가능성이 높습니다. 여기서 "lookup" 알고리즘의 명세에 유의하세요. 대부분의 인도네시아어 사용자가 인도네시아어도 이해하므로 "bestfit" 일치기는 인도네시아어가 발리어와 적절히 일치한다고 판단하여 발리어 태그도 반환할 수 있습니다.

js
const locales = ["ban", "id-u-co-pinyin", "de-ID"];
const options = { localeMatcher: "lookup" };
console.log(Intl.DateTimeFormat.supportedLocalesOf(locales, options));
// ["id-u-co-pinyin", "de-ID"]

명세서

Specification
ECMAScript Internationalization API Specification
# sec-intl.datetimeformat.supportedlocalesof

브라우저 호환성

BCD tables only load in the browser

같이 보기