Intl.Locale.prototype.getWeekInfo()

可用性有限

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

Intl.Locale 例項的 getWeekInfo() 方法返回一個 weekInfo 物件,其中包含此區域設定的 firstDayweekendminimalDays 屬性。

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

語法

js
getWeekInfo()

引數

無。

返回值

一個代表與 UTS 35 的周元素中指定的區域設定資料相關的周資訊的物件。它具有以下屬性:

firstDay

一個介於 1(星期一)和 7(星期日)之間的整數,表示該區域設定的星期開始日。通常為 1、5、6 或 7。

weekend

一個介於 1 和 7 之間的整數陣列,表示該區域設定的週末日期。這通常是連續的,因為 UTS 35 儲存的是 weekendStartweekendEnd

minimalDays

一個介於 1 和 7 之間的整數(通常為 1 和 4),表示月份或年份的第一週所需的最小天數,用於計算週數(例如,“一年中的第 20 周”)。例如,在 ISO 8601 日曆中,一年的第一週必須包含該年至少 4 天,因此如果 1 月 1 日是星期五、星期六或星期日,它將被編號為上一年最後一週的一部分。

示例

獲取周資訊

返回給定 Locale 的周資訊。

js
const he = new Intl.Locale("he"); // Hebrew (Israel)
console.log(he.getWeekInfo()); // { firstDay: 7, weekend: [5, 6], minimalDays: 1 }

const af = new Intl.Locale("af"); // Afrikaans (South Africa)
console.log(af.getWeekInfo()); // { firstDay: 7, weekend: [6, 7], minimalDays: 1 }

const enGB = new Intl.Locale("en-GB"); // English (United Kingdom)
console.log(enGB.getWeekInfo()); // { firstDay: 1, weekend: [6, 7], minimalDays: 4 }

const arAF = new Intl.Locale("ar-AF"); // Arabic (Afghanistan)
console.log(arAF.getWeekInfo()); // { firstDay: 6, weekend: [4, 5], minimalDays: 1 }

const dvMV = new Intl.Locale("dv-MV"); // Divehi (Maldives)
console.log(dvMV.getWeekInfo()); // { firstDay: 5, weekend: [6, 7], minimalDays: 1 }

規範

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

瀏覽器相容性

另見