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 oflocale.weekInfo === locale.weekInfo
returningfalse
. Check the browser compatibility table for details.
语法
参数
返回值
¥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 日是星期五、星期六或星期日,它将被编号为上一年最后一周的一部分。
示例
获取本周信息
¥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 |
浏览器兼容性
BCD tables only load in the browser
也可以看看
¥See also