Função MySQL DATE_FORMAT()

A função `DATE_FORMAT()` do MySQL é usada para formatar uma data conforme especificado por uma string de formato. Ele permite que você converta dados de data e hora em um formato legível por humanos ou em um formato específico exigido pelo seu aplicativo.

Uso

A função `DATE_FORMAT()` é utilizada quando você precisa exibir a data e a hora em um formato personalizado. Ele recebe uma data como primeiro argumento e uma string de formato como segundo argumento.

DATE_FORMAT(date, format)

Nessa sintaxe, `date` é a data a ser formatada e `format` é uma cadeia de caracteres que contém os especificadores de formato que definem o formato de saída.

Especificadores de formato comuns

• %Y: Ano, numérico, quatro dígitos
• %m: Mês, numérico (00...12)
• %d: Dia do mês, numérico (00...31)
• %H: Hora (00..23)
• %i: Minutos, numérico (00...59)
• %p: AM ou PM

Exemplos

1. Formatação de data básica

Para formatar uma data no formato de data padrão do MySQL:

SELECT DATE_FORMAT('2023-12-31', '%Y-%m-%d');

Esse exemplo formata a data `'2023-12-31'` como `2023-12-31`, ilustrando o uso básico de `DATE_FORMAT()` sem alterar o formato.

2. Exibição de data personalizada

Para exibir uma data com nomes completos de dia e mês:

SELECT DATE_FORMAT('2023-12-31', '%W, %M %e, %Y');

Isso formata a data como `Domingo, 31 de dezembro de 2023`, mostrando o uso de especificadores de formato para exibir o nome completo do dia, do mês e do dia do mês.

3. Formatação de data e hora

Para personalizar a apresentação de data e hora:

SELECT DATE_FORMAT('2023-12-31 15:45:30', '%d-%b-%Y %h:%i %p');

Aqui, a data e a hora `'2023-12-31 15:45:30'` são formatadas como `31-Dec-2023 03:45 PM`, demonstrando a capacidade de formatar os componentes de data e hora usando vários especificadores.

Tratamento de erros

Se você fornecer uma cadeia de caracteres de formato incorreta, `DATE_FORMAT()` poderá retornar resultados inesperados ou NULL. Certifique-se de que as cadeias de formato sejam validadas para evitar erros.

Dicas e práticas recomendadas

• Familiarize-se com os especificadores de formato. Entenda os especificadores disponíveis para uma formatação precisa.
• Garanta a consistência do formato. Mantenha formatos de data consistentes em todo o aplicativo.
• Lembre-se da localidade e dos fusos horários. Considere as diferenças de localidade e fuso horário.
• Teste os formatos minuciosamente. Valide formatos com várias entradas de data para garantir a renderização correta.