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 YEARWEEK
retorna um valor no yw
formato formato. por exemplo, 202312
, 2023
é o ano e 12
é o número da semana. A YEARWEEK()
função retorna NULL
se 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 mode
argumento especifica se o valor de retorno deve começar no intervalo de 0 a 53 ou de 1 a 53.
Se você omitir o mode
argumento, 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 202342
onde 2023
está o ano e 01
o 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.