Compartilhar via


Função de ER WEEKNUM

A função WEEKNUM retorna um valor Inteiro que representa a semana do ano que inclui um valor de Data especificado. O cálculo é baseado em regras dependentes da cultura que definem uma semana do 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 ser usada para calcular a semana do ano.

culture: Cadeia de caracteres

A cultura a ser usada para o cálculo. Você pode usar códigos de cultura com suporte de acordo com os padrões .NET.

Valores de retorno

Inteiro

O valor numérico resultante.

Notas de uso

A semana do ano é calculada com base no padrão ISO 8601, se esse padrão foi adotado por um país ou região para o qual o local é fornecido no tempo de execução. Caso contrário, o cálculo será baseado em padrões nacionais específicos do país/região.

Se um código de cultura sem suporte é fornecido como um argumento da função WEEKNUM no tempo de execução, uma exceção é lançada. Se a cadeia de caracteres em branco for fornecida como um código de cultura, o calendário neutro em relação ao país em inglês será usado para calcular o número da semana.

Exemplos

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

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

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

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

Recursos adicionais

Funções de data e de hora