As funções WeekNum e ISOWeekNum
Aplica-se a:
Aplicações de tela Aplicações condicionadas por modelo Power Pages Colunas de fórmulas do Dataverse
Devolve o número da semana de uma data específica.
Descrição
Utilize as funções WeekNum e ISOWeekNum para determinar o número da semana de uma data.
Estas funções diferem na forma como determinam a primeira semana do ano (semana 1):
WeekNum usa a semana que contém 1 de janeiro como a primeira semana do ano. O resultado desta função pode variar de 1 a 54.
ISOWeekNum utiliza a semana que contém a primeira quinta-feira do ano como primeira semana do ano. Isto segue a definição padrão de data e hora ISO 8601 para a numeração da semana. O resultado desta função pode variar de 1 a 53. É possível que 52 ou 53 possam ser devolvidos nos primeiros dias de janeiro, uma vez que as datas podem pertencer à última semana do ano anterior.
Utilize o segundo parâmetro para a WeekNum para especificar por que dia começa uma semana. Pode fornecer um número de código Excel ou utilizar a enumeração StartOfWeek:
| Código do Excel | Enumeração StartOfWeek | Descrição |
|---|---|---|
| 1, 17 | StartOfWeek.Sunday | A semana começa ao domingo. Predefinição. |
| 2, 11 | StartOfWeek.Monday | A semana começa à segunda-feira. |
| 12 | StartOfWeek.Tuesday | A semana começa à terça-feira. |
| 13 | StartOfWeek.Wednesday | A semana começa à quarta-feira. |
| 14 | StartOfWeek.Thursday | A semana começa à quinta-feira. |
| 15 | StartOfWeek.Friday | A semana começa à sexta-feira. |
| 16 | StartOfWeek.Saturday | A semana começa ao sábado. |
ISOWeekNum usa sempre a segunda-feira como início da semana. No Excel, a função WeekNum suporta um código de adição 21 que não é suportado aqui; utilize o ISOWeekNum em vez disso.
Se transmitir um único número a estas funções, o valor devolvido será um único resultado. Se passar uma tabela de coluna única que contenha números, o valor devolvido é uma tabela de coluna única de resultados, um resultado para cada registo na tabela do argumento. Se tiver uma tabela com várias colunas, pode formatá-las para uma tabela com uma única coluna, conforme descrito em trabalhar com tabelas.
Sintaxe
WeekNum(DateTime [, StartOfWeek ])
- DateTime – Necessário. Valor Data/Hora a utilizar.
- StartOfWeek – Opcional. Código Excel ou enumeração StartOfWeek que determina em que dia a semana começa.
ISOWeekNum(DateTime)
- DateTime – Necessário. Valor Data/Hora a utilizar. A semana começa sempre à segunda-feira.
Exemplos
Primeira e última semana de calendário de 2021
| Data | WeekNum( Date ) | ISOWeekNum( Date ) | WeekNum( Date, StartOfWeek.Wednesday ) |
|---|---|---|---|
| Sexta,janeiro1,2021 | 1 | 53 | 1 |
| Sábado,Janeiro2,2021 | 1 | 53 | 1 |
| Domingo,janeiro3,2021 | 2 | 53 | 1 |
| Segunda,janeiro4,2021 | 2 | 1 | 1 |
| Terça,janeiro5,2021 | 2 | 1 | 1 |
| Quarta,janeiro6,2021 | 2 | 1 | 2 |
| Quinta,janeiro7,2021 | 2 | 1 | 2 |
| Sábado,dezembro25,2021 | 52 | 51 | 52 |
| Domingo,dezembro26,2021 | 53 | 51 | 52 |
| Segunda,dezembro27,2021 | 53 | 52 | 52 |
| Terça,dezembro28,2021 | 53 | 52 | 52 |
| Quarta,dezembro29,2021 | 53 | 52 | 53 |
| Quinta,dezembro30,2021 | 53 | 52 | 53 |
| Sexta,dezembro31,2021 | 53 | 52 | 53 |