Поделиться через

Функции WeekNum и ISOWeekNum

  • Статья

Применимо к: приложениям на основе холста приложениям на основе модели Power Pages столбцам формул Dataverse

Возвращает номер недели для заданной даты.

Description

Используйте функции WeekNum и ISOWeekNum для определения номера недели для даты.

Эти функции различаются тем, как они определяют первую неделю года (неделя 1):

  • WeekNum использует неделю, содержащую 1 января как первую неделю года. Результат этой функции может быть от 1 до 54.

  • ISOWeekNum использует неделю, содержащую первый четверг года как первую неделю года. Это следует стандартному определению даты и времени ISO 8601 для нумерации недель. Результат этой функции может быть от 1 до 53. Возможно, что 52 или 53 могут быть возвращены для первых дней января, поскольку даты могут относиться к последней неделе предыдущего года.

Используйте второй параметр для WeekNum, чтобы указать, с какого дня начинается неделя. Вы можете указать либо кодовый номер Excel, либо использовать перечисление StartOfWeek:

Код Excel Перечисление StartOfWeek Описание
1, 17 StartOfWeek.Sunday Неделя начинается с воскресенья. По умолчанию.
2, 11 StartOfWeek.Monday Неделя начинается с понедельника.
12 StartOfWeek.Tuesday Неделя начинается со вторника.
13 StartOfWeek.Wednesday Неделя начинается со среды.
14 StartOfWeek.Thursday Неделя начинается с четверга.
15 StartOfWeek.Friday Неделя начинается с пятницы.
16 StartOfWeek.Saturday Неделя начинается с субботы.

ISOWeekNum всегда использует понедельник как начало недели. В Excel функция WeekNum поддерживает дополнительный код 21, который не поддерживается здесь; используйте вместо него ISOWeekNum.

Если этим функциям передать одно число, возвращается один результат. Если передать таблицу с одним столбцом, содержащим числовые значения, возвращается таблица с одним столбцом, содержащим результаты вычислений — по одному результату для каждой записи в таблице аргументов. Таблицу с несколькими столбцами можно преобразовать в таблицу с одним столбцом, как описано в статье об использовании таблиц.

Синтаксис

WeekNum(DateTime [, StartOfWeek ])

  • DateTime — обязательно. Значение даты и времени, для которого необходимо выполнить операцию.
  • StartOfWeek — необязательный параметр. Код Excel или перечисление StartOfWeek, определяющее день начала недели.

ISOWeekNum(DateTime)

  • DateTime — обязательно. Значение даты и времени, для которого необходимо выполнить операцию. Неделя всегда начинается в понедельник.

Примеры

Первая и последняя календарные недели 2021 года

Дата WeekNum( Date ) ISOWeekNum( Date ) WeekNum( Date, StartOfWeek.Wednesday )
Пятница,Январь1,2021 1 53 1
Суббота,Январь2,2021 1 53 1
Воскресенье,Январь3,2021 2 53 1
Понедельник,Январь4,2021 2 1 1
Вторник,Январь5,2021 2 1 1
Среда,Январь6,2021 2 1 2
Четверг,Январь7,2021 2 1 2
Суббота,Декабрь25,2021 52 51 52
Воскресенье,Декабрь26,2021 53 51 52
Понедельник,Декабрь27,2021 53 52 52
Вторник,Декабрь28,2021 53 52 52
Среда,Декабрь29,2021 53 52 53
Четверг,Декабрь30,2021 53 52 53
Пятницу,Декабрь31,2021 53 52 53