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

浏览器兼容性

另见