Intl.Locale.prototype.getWeekInfo()

Intl.Locale 实例的 getWeekInfo() 方法返回一个 weekInfo 对象,该对象具有该语言环境的属性 firstDayweekendminimalDays

¥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

js
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 存储 weekendStartweekendEnd

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.

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 }

规范

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

¥Specifications

浏览器兼容性

BCD tables only load in the browser

¥Browser compatibility

也可以看看

¥See also