Intl.Locale.prototype.calendar
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
인스턴스의 calendar
접근자 속성은 해당 로케일의 달력 유형을 반환합니다.
설명
전 세계 대부분은 그레고리력을 사용하지만, 세계 곳곳에서는 여러 지역 달력이 있습니다. calendar
속성의 값은 로케일 식별자의 ca
키 또는 Intl.Locale()
생성자의 calendar
옵션을 통해 구성 시 설정됩니다. 둘 다 존재하면 후자를 우선하며, 둘 다 존재하지 않으면 속성의 값은 undefined
이 됩니다.
지원하는 모든 달력 유형의 목록은 Intl.Locale.prototype.getCalendars()
을 참고하시기 바랍니다..
calendar
의 설정 접근자는 undefined
입니다. 이 속성을 직접 변경할 수 없습니다.
예제
다른 로케일 하위 태그와 마찬가지로 달력 유형은 로케일 문자열 또는 생성자에 대한 구성 객체 인수를 통해 Intl.Locale
객체에 추가할 수 있습니다.
로케일 문자열을 통한 달력 유형 추가하기
유니코드 로케일 문자열 사양에서 달력의 유형은 로케일 키 "확장 하위 태그"입니다. 이러한 하위 태그는 로케일에 대한 추가 데이터를 더하며, -u
확장자를 사용하여 로케일 식별자에 추가됩니다. 따라서 달력 연도 유형은 Intl.Locale()
생성자에 전달되는 초기 로케일 식별자 문자열에 추가할 수 있습니다. 캘린더 유형을 추가하려면 먼저 문자열에 -u
확장자를 추가합니다. 다음으로 -ca
확장자를 추가하여 캘린더 유형을 추가하고 있음을 나타냅니다. 마지막으로 문자열에 달력 유형을 추가합니다.
const locale = new Intl.Locale("fr-FR-u-ca-buddhist");
console.log(locale.calendar); // Prints "buddhist"
구성 객체 인수를 통한 달력 유형 추가하기
Intl.Locale()
생성자에는 달력을 비롯한 여러 확장 유형 중 하나를 포함할 수 있는 선택적 구성 객체 인수가 있습니다. 구성 객체의 calendar
속성을 원하는 달력 연도로 설정한 다음 생성자에 전달합니다.
const locale = new Intl.Locale("fr-FR", { calendar: "buddhist" });
console.log(locale.calendar); // "buddhist"
명세서
Specification |
---|
ECMAScript Internationalization API Specification # sec-Intl.Locale.prototype.calendar |
브라우저 호환성
BCD tables only load in the browser
같이 보기
Intl.Locale
Intl.Locale.prototype.getCalendars()
- 유니코드 달력 식별자 in the Unicode locale data markup language spec