Função MySQL YEARWEEK()

Resumo : neste tutorial, você aprenderá como usar a YEARWEEK()função MySQL para retornar ano e semana para uma data.

Introdução à função MySQL YEARWEEK()

A YEARWEEK()função retorna o ano e a semana de uma data .

Aqui está a sintaxe da YEARWEEK()função:

YEARWEEK(date)Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

Nesta sintaxe:

  • date: Esta é a data da qual você deseja extrair o ano e a semana.

O YEARWEEKretorna um valor no ywformato formato. por exemplo, 202312, 2023 é o ano e 12é o número da semana. A YEARWEEK()função retorna NULLse a data for NULL.

A YEARKWEEK()função também aceita um segundo argumento:

YEARWEEK(date,mode)Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

Nesta sintaxe, o modeargumento especifica se o valor de retorno deve começar no intervalo de 0 a 53 ou de 1 a 53.

Se você omitir o modeargumento, a YEARWEEK()função usará o valor da variável do sistema @@default_week_format:

SELECT @@default_week_format;Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

Saída:

+-----------------------+
| @@default_week_format |
+-----------------------+
|                     0 |
+-----------------------+
1 row in set (0.00 sec)Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

A saída mostra que o formato de semana padrão é 0, o que significa que o primeiro dia da semana é domingo e o intervalo da semana é de 0 a 53.

A tabela a seguir mostra todos os modos válidos que você pode usar:

Modo Primeiro dia da semana Faixa A semana 1 é a primeira semana em que…
0 Domingo 0-53 com domingo neste ano Qualquer domingo do ano
1 Segunda-feira 0-53 com 4 ou mais dias este ano Pelo menos 4 dias caem dentro do ano
2 Domingo 1-53 com domingo neste ano Qualquer domingo do ano, a partir da semana 1
3 Segunda-feira 1-53 com 4 ou mais dias este ano Pelo menos 4 dias caem no ano, começando na semana 1
4 Domingo 0-53 com 4 ou mais dias este ano Qualquer domingo do ano, a partir da semana 1
5 Segunda-feira 0-53 com segunda-feira neste ano Qualquer segunda-feira do ano
6 Domingo 1-53 com 4 ou mais dias este ano Pelo menos 4 dias caem no ano, começando na semana 1
7 Segunda-feira 1-53 com segunda-feira neste ano Qualquer segunda-feira do ano, a partir da semana 1

Exemplos de funções MySQL YEARWEEK

Tomaremos alguns exemplos de uso da YEARWEEK()função MySQL.

1) Exemplo simples de função YEARWEEK()

O exemplo a seguir usa a YEARWEEK()função para obter o ano e a semana da data ‘2023-10-17’:

SELECT YEARWEEK('2023-01-01');Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

Saída:

+------------------------+
| YEARWEEK('2023-01-01') |
+------------------------+
|                 202301 |
+------------------------+
1 row in set (0.00 sec)Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

Ele retorna 202342onde 2023está o ano e 01o número da semana.

2) O exemplo da função YEARWEEK() com o argumento mode

O exemplo a seguir usa a YEARWEEK()função com modo 3. Ele retorna um resultado diferente com base na regra do modo 3:

SELECT YEARWEEK('2023-01-01',3);Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

Saída:

+--------------------------+
| YEARWEEK('2023-01-01',3) |
+--------------------------+
|                   202252 |
+--------------------------+
1 row in set (0.00 sec)Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

Resumo

  • Use a YEARWEEK()função MySQL para retornar o ano e a semana para uma data.

Deixe um comentário

O seu endereço de email não será publicado. Campos obrigatórios marcados com *