Intl.Locale.prototype.getWeekInfo()

Intl.Locale 实例的 getWeekInfo() 方法返回一个 weekInfo 对象，该对象具有该语言环境的属性 firstDay、weekend 和 minimalDays。

¥The getWeekInfo() method of Intl.Locale instances returns a weekInfo object with the properties firstDay, weekend and minimalDays for this locale.

注意：在某些浏览器的某些版本中，此方法被实现为名为 weekInfo 的访问器属性。但是，由于它在每次访问时都会返回一个新对象，因此现在将其实现为一种方法，以防止出现 locale.weekInfo === locale.weekInfo 返回 false 的情况。检查浏览器兼容性表了解详细信息。

¥Note: In some versions of some browsers, this method was implemented as an accessor property called weekInfo. However, because it returns a new object on each access, it is now implemented as a method to prevent the situation of locale.weekInfo === locale.weekInfo returning false. Check the browser compatibility table for details.

语法

¥Syntax

getWeekInfo()

参数

¥Parameters

没有任何。

¥None.

返回值

¥Return value

表示与 UTS 35 周要素中指定的区域设置数据关联的周信息的对象。它具有以下属性：

¥An object representing week information associated with the Locale data specified in UTS 35's Week Elements. It has the following properties:

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 日是星期五、星期六或星期日，它将被编号为上一年最后一周的一部分。

示例

¥Examples

获取本周信息

¥Obtaining the Week Information

返回给定 Locale 的周信息。

¥Return the week information for a given Locale.

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 }

规范

Specification
Intl Locale Info Proposal # sec-Intl.Locale.prototype.getWeekInfo

¥Specifications

浏览器兼容性

BCD tables only load in the browser

¥Browser compatibility

也可以看看

¥See also

Intl.Locale