Функции WeekNum и ISOWeekNum
Применимо к:
Приложениям Canvas Приложениям на основе моделей 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 | НачалоНедели.Воскресенье | Неделя начинается с воскресенья. По умолчанию. |
| 2, 11 | НачалоНедели.Понедельник | Неделя начинается с понедельника. |
| 12 | НачалоНедели.Вторник | Неделя начинается со вторника. |
| 13 | НачалоНедели.Среда | Неделя начинается со среды. |
| 14 | Начало недели.четверг | Неделя начинается с четверга. |
| 15 | НачалоНедели.Пятница | Неделя начинается с пятницы. |
| 16 | НачалоНедели.Суббота | Неделя начинается с субботы. |
ISOWeekNum всегда использует понедельник в качестве начала недели. В Excel функция WeekNum поддерживает дополнительный код 21, который не поддерживается здесь; используйте вместо него ISOWeekNum.
Если этим функциям передать одно число, возвращается один результат. Если передать таблицу с одним столбцом, содержащим числовые значения, возвращается таблица с одним столбцом, содержащим результаты вычислений — по одному результату для каждой записи в таблице аргументов. Таблицу с несколькими столбцами можно преобразовать в таблицу с одним столбцом, как описано в статье об использовании таблиц.
Синтаксис
WeekNum(ДатаВремя [, НачалоНедели ])
- Дата и время - Обязательно. Значение даты и времени, для которого необходимо выполнить операцию.
- Начало недели - Необязательно. Код Excel или перечисление StartOfWeek, определяющее день начала недели.
ISOWeekNum(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 |