Resumo : neste tutorial, você aprenderá como usar a TIME_FORMAT()
função MySQL para formatar valores de hora.
Introdução à função MySQL TIME_FORMAT()
A TIME_FORMAT()
função permite formatar um valor de tempo de acordo com um formato específico.
Aqui está a sintaxe da TIME_FORMAT()
função:
TIME_FORMAT(time, format)
Linguagem de código: SQL (linguagem de consulta estruturada) ( sql )
Nesta sintaxe:
time
: o valor de tempo que você deseja formatar.format
: a string de formato que determina como você deseja formatar o valor de hora.
O TIME_FORMAT()
retorna uma string representando a hora formatada de acordo com a string de formato.
Se a hora ou formato for NULL
, a TIME_FORMAT()
função retornará NULL
.
Como TIME_FORMAT()
apenas formata dados de hora, a string de formato contém especificadores de formato apenas para horas, minutos, segundos e microssegundos.
A TIME_FORMAT()
função é útil para apresentar dados de tempo em vários formatos para torná-los adequados às suas aplicações.
Especificadores de formato de hora
Veja a seguir uma lista de alguns especificadores de formato comuns que você pode usar na TIME_FORMAT()
função:
%H
: Hora (00-23)%h
: Hora (01-12)%i
: Minutos (00-59)%s
: Segundos (00-59)%p
: AM ou PM
Exemplos de funções MySQL TIME_FORMAT()
Vejamos alguns exemplos de uso da TIME_FORMAT()
função.
1) Exemplo simples de função TIMEFORMAT()
O exemplo a seguir usa a TIME_FORMAT()
função para formatar o valor literal de tempo '15:30:45'
:
SELECT TIME_FORMAT('15:30:45', '%h:%i %p');
Linguagem de código: SQL (linguagem de consulta estruturada) ( sql )
Saída:
+-------------------------------------+
| TIME_FORMAT('15:30:45', '%h:%i %p') |
+-------------------------------------+
| 03:30 PM |
+-------------------------------------+
1 row in set (0.00 sec)
Linguagem de código: texto simples ( texto simples )
2) Usando a função TIME_FORMAT() com dados da tabela
Primeiro, crie uma nova tabela chamada appointments
com a seguinte estrutura:
CREATE TABLE appointments (
id INT AUTO_INCREMENT PRIMARY KEY,
time TIME NOT NULL,
description VARCHAR(255) NOT NULL
);
Linguagem de código: SQL (linguagem de consulta estruturada) ( sql )
A appointments
tabela possui três colunas:
id
: uma chave primária incrementada automaticamente.time
: Uma coluna para armazenar a hora do compromisso.description
: uma coluna para armazenar uma descrição do compromisso.
Segundo, insira algumas linhas na appointments
tabela:
INSERT INTO appointments (time, description)
VALUES
('10:00:00', 'Meeting with client'),
('14:30:00', 'Team discussion'),
('16:45:00', 'Project presentation'),
('18:15:00', 'Dinner with colleagues');
Linguagem de código: SQL (linguagem de consulta estruturada) ( sql )
Terceiro, use a TIME_FORMAT()
função para formatar os dados de horário da appointments
tabela:
SELECT
id,
description,
TIME_FORMAT(time, '%h:%i %p') AS time
FROM
appointments;
Linguagem de código: SQL (linguagem de consulta estruturada) ( sql )
Saída:
+----+------------------------+----------+
| id | description | time |
+----+------------------------+----------+
| 1 | Meeting with client | 10:00 AM |
| 2 | Team discussion | 02:30 PM |
| 3 | Project presentation | 04:45 PM |
| 4 | Dinner with colleagues | 06:15 PM |
+----+------------------------+----------+
4 rows in set (0.00 sec)
Linguagem de código: texto simples ( texto simples )
Neste exemplo, selecionamos dados da appointments
tabela e usamos a TIME_FORMAT()
função para formatar a time
coluna em um formato mais legível.
Resumo
- Use a
TIME_FORMAT()
função para formatar um valor de tempo de acordo com um formato.