Intl.Locale.prototype.getWeekInfo()
getWeekInfo()
是 Intl.Locale
实例的一个方法,它返回一个 weekInfo
对象,其中包含此区域设置的 firstDay
、weekend
和 minimalDays
属性。
注意:在某些版本的某些浏览器中,此方法被实现为一个名为 weekInfo
的访问器属性。但是,因为它在每次访问时都会返回一个新对象,所以现在它被实现为一个方法,以防止 locale.weekInfo === locale.weekInfo
返回 false
的情况。有关详细信息,请查看 浏览器兼容性表格。
语法
js
getWeekInfo()
参数
无。
返回值
一个表示与 UTS 35 的星期元素 中指定的区域设置数据关联的星期信息的物件。它具有以下属性
firstDay
-
一个介于 1(星期一)和 7(星期日)之间的整数,指示该区域设置的星期第一天。通常是 1、5、6 或 7。
weekend
-
一个介于 1 和 7 之间的整数数组,指示该区域设置的周末日期。这通常是连续的,因为 UTS 35 存储
weekendStart
和weekendEnd
而不是。 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 区域设置信息提案 # sec-Intl.Locale.prototype.getWeekInfo |
浏览器兼容性
BCD 表格仅在启用了 JavaScript 的浏览器中加载。