Intl.Locale.prototype.getWeekInfo()

Базовый уровень Недавно появилось

Эта функция работает на самых последних устройствах и версиях браузеров. Эта функция может не работать в старых устройствах или версиях браузеров. Она доступна во всех браузерах с июля 2026 года.

Метод getWeekInfo() экземпляров Intl.Locale возвращает объект weekInfo со свойствами firstDay, weekend и minimalDays для этой локали.

Примечание: В некоторых версиях некоторых браузеров этот метод был реализован как свойство-аксессор под названием weekInfo. Однако, поскольку он возвращает новый объект при каждом обращении, теперь он реализован как метод, чтобы предотвратить ситуацию, когда locale.weekInfo === locale.weekInfo возвращает false. Подробности смотрите в таблице совместимости с браузерами.

Синтаксис

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 января приходится на пятницу, субботу или воскресенье, она будет пронумерована как часть последней недели предыдущего года.

Примеры

Получение информации о неделе

Возвращение информации о неделе для заданной 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 }

Спецификации

Спецификация
Intl Locale Info Proposal # sec-Intl.Locale.prototype.getWeekInfo

Совместимость с браузерами

	ПК					Мобильные							Сервер
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS	Bun	Deno	Node.js
`getWeekInfo`	130 99 Реализовано как свойство-аксессор.	130 99 Реализовано как свойство-аксессор.	153	115 85 Реализовано как свойство-аксессор.	17 15.4–preview Реализовано как свойство-аксессор.	130 99 Реализовано как свойство-аксессор.	153	86 68 Реализовано как свойство-аксессор.	17 15.4 Реализовано как свойство-аксессор.	28.0 18.0 Реализовано как свойство-аксессор.	130 99 Реализовано как свойство-аксессор.	17 15.4 Реализовано как свойство-аксессор.	1.0.0	2.1 1.19–2.6.7 Реализовано как свойство-аксессор.	24.0.0 18.0.0 Реализовано как свойство-аксессор.
`returns_minimalDays_property`	99–136	99–136	Нет	85–121	15.4	99–136	Нет	68–90	15.4	18.0–29.0	99–136	15.4	1.0.0	1.19	18.0.0–24.0.0

Смотрите также

Intl.Locale

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/getWeekInfo