Pular para o conteúdo principal

VillageSQL is a drop-in replacement for MySQL with extensions.

All examples on this page work on VillageSQL. Install Now →
O MySQL oferece um conjunto completo de funções de data e hora. Os principais tipos com que você vai trabalhar são DATE (apenas data), TIME (apenas hora), DATETIME (data + hora, sem fuso horário) e TIMESTAMP (data + hora, armazenado em UTC, exibido no fuso horário da sessão). Consulte Timestamps e Fusos Horários no MySQL para detalhes sobre o tratamento de fusos horários.

Obtendo a Data e a Hora Atuais

NOW() é avaliado uma vez no início de uma instrução — todas as linhas do mesmo INSERT recebem o mesmo timestamp. SYSDATE() é avaliado a cada vez que é chamado.

Formatando Datas

DATE_FORMAT converte uma data ou datetime em uma string usando uma string de formato:
Especificadores de formato comuns:

Convertendo Strings em Datas

STR_TO_DATE converte uma string em uma data usando os mesmos especificadores de formato:
Retorna NULL se a string não corresponder ao formato.

Aritmética de Datas

DATE_ADD / DATE_SUB — somam ou subtraem um intervalo:
Unidades de intervalo: SECOND, MINUTE, HOUR, DAY, WEEK, MONTH, QUARTER, YEAR. Forma abreviada com os operadores + e -:
DATEDIFF — dias entre duas datas:
DATEDIFF conta apenas dias, não a hora. Para diferenças que consideram a hora, use TIMESTAMPDIFF:
TIMESTAMPDIFF(unit, from, to) — observe que from vem antes de to.

Extraindo Partes da Data

EXTRACT / YEAR / MONTH / DAY:
DAYOFWEEK / DAYOFYEAR / WEEK:

Truncando para um Período

Para agrupar dados por mês, semana ou dia, trunque o datetime para o limite do período:

Timestamps Unix

Padrões Comuns

Registros dos últimos 30 dias:
Registros do mês atual:
Idade a partir de uma data de nascimento:

Perguntas Frequentes

Qual é a diferença entre NOW() e SYSDATE()?

NOW() retorna o timestamp de quando a instrução começou a executar — todas as linhas de um único INSERT ou UPDATE recebem o mesmo valor. SYSDATE() retorna a hora real do relógio no momento em que é chamado, então linhas inseridas em um loop recebem valores diferentes. Para timestamps de auditoria em que a consistência dentro de uma transação importa, NOW() é quase sempre a escolha certa.

Por que DATE_ADD com INTERVAL 1 MONTH se comporta de forma estranha no fim do mês?

O MySQL ajusta para o último dia válido. DATE_ADD('2024-01-31', INTERVAL 1 MONTH) retorna 2024-02-29 (ano bissexto) ou 2024-02-28. Esse é o comportamento esperado — não existe “31 de fevereiro”. Se você precisa de aritmética de meses previsível, trunque primeiro para o início do mês.

Solução de Problemas

Veja também