Partilhar via


Função de ER WEEKNUM

A função WEEKNUM devolve um valor Número inteiro que representa a semana do ano que inclui um valor Data especificado. O cálculo baseia-se em regras dependentes da cultura que definem uma semana de calendário e o primeiro dia da semana.

Sintaxe

WEEKNUM (date, culture) as Integer

Argumentos

date: Data

Um valor de data que representa a data a utilizar para calcular a semana do ano.

culture: Cadeia

A cultura a utilizar para o cálculo. Pode utilizar os códigos de culturas suportados de acordo com as normas .NET.

Valores de retorno

Número Inteiro

O valor numérico resultante.

Notas de utilização

A semana do ano é calculada com base na norma ISO 8601, se esta norma tiver sido adotada por um país ou uma região para a região fornecida durante a execução. Caso contrário, o cálculo baseia-se em normas nacionais específicas para o país/região.

Se um código de cultura não suportado for fornecido como um argumento da função WEEKNUM durante a execução, uma exceção é iniciada. Se a cadeia em branco for fornecida como um código de cultura, o calendário neutro do país em inglês é utilizado para calcular o número da semana.

Exemplos

WEEKNUM (DATEVALUE ("01-01-2020", "de")) devolve 1.

WEEKNUM (DATEVALUE ("01-01-2021", "de")) devolve 53.

WEEKNUM (DATEVALUE ("01-01-2022", "de")) devolve 52.

WEEKNUM (DATEVALUE ("01-01-2022", "ar")) devolve 21.

Recursos adicionais

Funções de data e hora