Функції WeekNum та ISOWeekNum
Застосовується до:
Програми Canvas Стовпці формул програм на основі Dataverse моделі
Повертає номер тижня для певної дати.
Опис
Щоб визначити номер тижня для дати, використовуйте функції 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 |