O mundo de MySQL & MariaDB

Como usar o MySQL DATE_FORMAT: Guia prático para formatar datas

Funções
目次

1. Introdução

Nos bancos de dados MySQL, o manuseio de dados de data e hora é uma tarefa comum. Embora as datas sejam geralmente armazenadas em um formato padrão, muitas vezes é necessário apresentá-las aos usuários em um formato mais legível ou personalizado. É aí que a função DATE_FORMAT se torna útil. Neste artigo, explicaremos como usar a função DATE_FORMAT, introduziremos suas várias opções de formatação e forneceremos exemplos práticos para mostrar como você pode usá-la de forma eficaz.

2. Visão Geral da Função DATE_FORMAT

2.1 O que é a Função DATE_FORMAT?

A função DATE_FORMAT no MySQL é usada para converter dados de data em um formato especificado. Em vez de exibir o formato padrão YYYY-MM-DD ou timestamp, você pode usar esta função para exibir datas em qualquer estilo que preferir. Por exemplo, se você quiser mostrar uma data como “16 de Setembro de 2024” para os usuários, esta função é o caminho a seguir.

2.2 Sintaxe Básica

A sintaxe básica para a função DATE_FORMAT é a seguinte:

DATE_FORMAT(date, format)
  • date : O valor de data que você deseja formatar.
  • format : Uma string que especifica o formato de saída da data.

Vamos olhar para um exemplo simples:

SELECT DATE_FORMAT('2024-09-16', '%Y年%m月%d日') AS formatted_date;

Esta consulta converte a data ‘2024-09-16’ para o formato “2024年09月16日”.

3. Parâmetros de Formato de Data

3.1 Lista de Especificadores de Formato

Existem muitos especificadores de formato disponíveis para a função DATE_FORMAT. Aqui estão alguns dos mais comumente usados:

  • %Y : Ano com quatro dígitos (ex.: 2024)
  • %y : Ano com dois dígitos (ex.: 24)
  • %m : Mês com dois dígitos (01 a 12)
  • %c : Mês (1 a 12)
  • %d : Dia do mês com dois dígitos (01 a 31)
  • %e : Dia do mês (1 a 31)
  • %H : Hora no formato 24 horas (00 a 23)
  • %h ou %I : Hora no formato 12 horas (01 a 12)
  • %i : Minutos (00 a 59)
  • %s : Segundos (00 a 59)
  • %p : AM ou PM

3.2 Exemplos Práticos

Vamos ver como esses especificadores afetam realmente a saída.

SELECT 
    DATE_FORMAT('2024-09-16 14:35:59', '%Y-%m-%d %H:%i:%s') AS full_format,
    DATE_FORMAT('2024-09-16 14:35:59', '%Y年%m月%d日') AS japanese_format,
    DATE_FORMAT('2024-09-16 14:35:59', '%d/%m/%Y') AS european_format,
    DATE_FORMAT('2024-09-16 14:35:59', '%h:%i %p') AS twelve_hour_format;

Esta consulta produz a seguinte saída:

  • full_format : 2024-09-16 14:35:59
  • japanese_format : 2024年09月16日
  • european_format : 16/09/2024
  • twelve_hour_format : 02:35 PM

4. Exemplos de Uso Prático

4.1 Cenário 1: Gerando Relatórios

Por exemplo, ao criar relatórios mensais para uma empresa, você pode querer exibir datas no formato “YYYY年MM月”. A consulta a seguir demonstra como formatar as datas do relatório de acordo:

SELECT 
    DATE_FORMAT(sale_date, '%Y年%m月') AS report_month,
    SUM(sales) AS total_sales
FROM sales_data
GROUP BY report_month;

Esta consulta exibe os totais de vendas mensais em um formato como “2024年09月”.

4.2 Cenário 2: Interfaces de Usuário

A função DATE_FORMAT também é útil para exibir datas de forma amigável ao usuário em aplicativos web. Por exemplo, para mostrar a data do último login em uma página de perfil do usuário:

SELECT 
    user_name,
    DATE_FORMAT(last_login, '%Y/%m/%d %H:%i') AS last_login_formatted
FROM users;

Isso exibirá a data e hora do último login do usuário como “2024/09/16 14:35”.

4.3 Cenário 3: Otimização de Consultas

A DATE_FORMAT também pode auxiliar na otimização de consultas de banco de dados. Por exemplo, para extrair registros dentro de um mês específico, você pode usar uma data formatada na cláusula WHERE:

SELECT 
    *
FROM transactions
WHERE DATE_FORMAT(transaction_date, '%Y-%m') = '2024-09';

Esta consulta extrai todas as transações de setembro de 2024.

5. Pontos a Notar e Melhores Práticas com DATE_FORMAT

5.1 Considerações de Desempenho

O uso frequente de DATE_FORMAT pode impactar o desempenho, especialmente em grandes conjuntos de dados. Se você o utilizar repetidamente, o tempo de processamento pode aumentar. Dependendo das suas necessidades, considere salvar as datas formatadas com antecedência ou tratar a formatação de datas no nível da aplicação.

5.2 Localização

Se você está construindo um sistema multilíngue com DATE_FORMAT, preste atenção à localização. Como os formatos de data variam por país ou região, você deve ajustar os formatos dinamicamente de acordo com o locale do usuário.

5.3 Formatação Consistente

Usar um formato de data consistente em todo o seu sistema é fundamental para uma melhor experiência do usuário. Por exemplo, use o mesmo formato para formulários de entrada, áreas de exibição e relatórios para evitar confundir seus usuários.

6. Conclusão

A função DATE_FORMAT é uma ferramenta poderosa para formatação flexível de datas no MySQL. Cobrimos os básicos, uso prático e dicas importantes e melhores práticas. Ao dominar esta função, você pode exibir datas de maneiras fáceis de ler e amigáveis ao usuário. Como próximo passo, recomendamos explorar manipulações mais avançadas de data e hora.

7. Referências e Leituras Adicionais

Esperamos que este artigo ajude você a entender e utilizar a função DATE_FORMAT de forma eficaz.