VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
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:
Convertendo Strings em Datas
STR_TO_DATE converte uma string em uma data usando os mesmos especificadores de formato:
Aritmética de Datas
DATE_ADD / DATE_SUB — somam ou subtraem um intervalo:SECOND, MINUTE, HOUR, DAY, WEEK, MONTH, QUARTER, YEAR.
Forma abreviada com os operadores + e -:
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: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: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
- Timestamps e Fusos Horários no MySQL — os tipos de armazenamento sobre os quais as funções de data operam
- MySQL BETWEEN — por que um intervalo de datas é mais seguro escrito com
>=e<