Intl.Locale.prototype.getCalendars()

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

getCalendars() 方法是 Intl.Locale 例項的一個方法,它返回該區域設定的一個或多個唯一的日曆識別符號列表。

注意: 在某些瀏覽器版本的某些版本中,此方法被實現為一個名為 calendars 的訪問器屬性。但是,因為它每次訪問都會返回一個新的陣列,所以現在它被實現為一個方法,以防止 locale.calendars === locale.calendars 返回 false 的情況。有關詳細資訊,請檢視 瀏覽器相容性表格

語法

js
getCalendars()

引數

無。

返回值

一個字串陣列,表示該 Locale 常用的所有日曆,按偏好降序排序。如果 Locale 已經有了一個 calendar,則返回的陣列包含該單個值。

支援的日曆型別的列表,請參閱 Intl.supportedValuesOf()

示例

獲取支援的日曆

如果 Locale 物件還沒有 calendargetCalendars() 會列出給定 Locale 常用的所有日曆。有關顯式設定 calendar 的示例,請參閱 calendar 示例

js
const arEG = new Intl.Locale("ar-EG");
console.log(arEG.getCalendars()); // ["gregory", "coptic", "islamic", "islamic-civil", "islamic-tbla"]
js
const jaJP = new Intl.Locale("ja-JP");
console.log(jaJP.getCalendars()); // ["gregory", "japanese"]

規範

規範
Intl Locale Info Proposal
# sec-Intl.Locale.prototype.getCalendars

瀏覽器相容性

另見