Funções WeekNum e ISOWeekNum
Aplica-se a:
Aplicativos Canvas Aplicativos baseados em modelos Power Pages Dataverse Colunas de fórmula
Retorna o número da semana de uma data específica.
Description
Use as funções WeekNum e ISOWeekNum para determinar o número da semana de uma data.
Essas 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 dessa função pode variar de 1 a 54.
ISOWeekNum usa a semana que contém a primeira quinta-feira do ano como a primeira semana do ano. Isso segue a Definição padrão de data e hora do ISO 8601 para numeração da semana. O resultado dessa função pode variar de 1 a 53. É possível que 52 ou 53 sejam devolvidos para os primeiros dias de janeiro, pois as datas podem pertencer à última semana do ano anterior.
Use o segundo parâmetro para WeekNum para especificar qual dia começa uma semana. Você pode fornecer um número de código do Excel ou usar a enumeração StartOfWeek:
| Código do Excel | Enumeração StartOfWeek | Descrição |
|---|---|---|
| 1, 17 | InícioDaSemana.Domingo | A semana começa no domingo. Padrão. |
| 2, 11 | InícioDaSemana.Segunda-feira | A semana começa na segunda-feira. |
| 12 | InícioDaSemana.Terça-feira | A semana começa na terça-feira. |
| 13 | InícioDaSemana.Quarta-feira | A semana começa na quarta-feira. |
| 14 | InícioDaSemana.Quinta-feira | A semana começa na quinta-feira. |
| 15 | InícioDaSemana.Sexta-feira | A semana começa na sexta-feira. |
| 16 | InícioDaSemana.Sábado | A semana começa no sábado. |
ISOWeekNum sempre usa segunda-feira como o início da semana. No Excel, a função WeekNum oferece suporte a um código de adição 21 que não é compatível aqui; use ISOWeekNum em vez disso.
Se você passar um número para essas funções, o valor de retorno será um resultado único. Se você passar uma tabela de coluna única que contém números, o valor retornado é uma tabela de resultados de coluna única, com um resultado para cada registro na tabela do argumento. Se você tiver uma tabela de várias colunas, é possível formatá-la como uma tabela de coluna única, como descrito em Trabalhando com tabelas.
Sintaxe
WeekNum(DataHora [, InícioDaSemana ])
- DateTime - Obrigatório. Valor de data/hora no qual operar.
- StartOfWeek - Opcional. Código do Excel ou enumeração StartOfWeek que determina em que dia a semana começa.
ISOWeekNum(DateTime)
- DateTime - Obrigatório. Valor de data/hora no qual operar. A semana sempre começa na segunda-feira.
Exemplos
Primeira e última semanas de calendário de 2021
| Date | WeekNum( Date ) | ISOWeekNum( Date ) | WeekNum( Date, StartOfWeek.Wednesday ) |
|---|---|---|---|
| Sexta-feira,1de janeiro,de 2021 | 1 | 53 | 1 |
| Sábado,2de janeiro,de 2021 | 1 | 53 | 1 |
| Domingo,3de janeiro,de 2021 | 2 | 53 | 1 |
| Segunda-feira,4de janeirode 2021 | 2 | 1 | 1 |
| Terça-feira,5de janeirode 2021 | 2 | 1 | 1 |
| Quarta-feira,6de janeirode 2021 | 2 | 1 | 2 |
| Quinta-feira,7de janeirode 2021 | 2 | 1 | 2 |
| Sábado,25de dezembrode 2021 | 52 | 51 | 52 |
| Domingo,26de dezembrode 2021 | 53 | 51 | 52 |
| Segunda-feira,27de dezembrode 2021 | 53 | 52 | 52 |
| Terça-feira,28de dezembrode 2021 | 53 | 52 | 52 |
| Quarta-feira,29de dezembrode 2021 | 53 | 52 | 53 |
| Quinta-feira,30de dezembrode 2021 | 53 | 52 | 53 |
| Sexta-feira,31de dezembrode 2021 | 53 | 52 | 53 |