Fun��es de manipula��o de hora no MySQL

Ol� pessoal, neste artigo vou demostrar algumas funç�es que o SGBD MySQL nos fornece para manipularmos horas internamente no banco usando SQL. Geralmente efetuamos esse tipo de tratamento internamente na aplicaç�o, independente da linguagem em que esteja sendo desenvolvida a aplicaç�o.

Nesse artigo vou usar o MySQL 5.5.13, sem nenhum tipo de interface gr�fica para gerenciamento, vamos acessar o MySQL atrav�s do prompt de comando do pr�prio Windows 7.

Para iniciar o prompt basta clicar em INICAR>EXECUTAR e digitar �cmd� ou v� at� acess�rios e selecione a opç�o correspondente.

Iniciando MySQL no prompt basta digitar: �mysql �u <seu_usu�rio> -p <sua_senha>�

Figura 1: Imagem inicial de acesso ao MySQL via prompt

Funç�o CURTIME() ou CURRENT_TIME()

Vamos começar demonstrando como retornar a data atual do servidor. Podemos usar a funç�o �CURTIME()� ou �CURRENT_TIME()�. Digite no prompt a seguinte instruç�o:

Listagem 1: Instruç�o SQL para retornar data atual do servidor


      SELECT CURTIME();
      ou
      SELECT CURRENT_TIME();

Figura 2: Hora atual do servidor

Funç�o TIME_FORMAT()

Essa funç�o tem a finalidade de formatar horas, ela � muito semelhante � funç�o �DATE_FORMAT()� para formatar datas. Podemos usar especificadores de formato tais como: hora, minuto, segundo e microsegundos. Para us�-la temos que passar 2 par�metros, o primeiro tem que ser o valor da hora que ser� formatada e o segundo uma string especificando o tipo de formato.

Listagem 2: Funç�o TIME_FORMAT(), passando como par�metro hora atual e o formato desejado

SELECT CURTIME() AS HORA, TIME_FORMAT(CURTIME(), '%h - %i - %s') AS HORA_FORMATADA;

Figura 3: Descriç�o

Notem que nesse exemplo a instruç�o retornou 2 valores, o primeiro exibe a hora no formato normal e o segundo exibe de acordo com o formato que foi passado como par�metro.

Observaç�es:o par�metro �%� � obrigat�rio antes de informar os caracteres de formato. Abaixo seguem alguns formatos aceitos:

Especificaç�o	Descriç�o
%h	Hora (01..12)
%H	Hora (00..23)
$i	Minutos, num�rico (00..59)
%s	Segundos (00..59)
%r	Tempo, 12 horas (hh:mm:ss seguido por AM ou Pm)
%T	Hor�rio, 24 horas (hh:mm:ss)

Funç�o CURRENT_TIMESTAMP()

Essa funç�o retorna a data e hora atual do servidor, geralmente � usada para gravar data e hora de aç�es (INSERTS, UPDATES E DELETES) em determinada tabela, uma esp�cie de log.

Listagem 3: Instruç�o para retornar data e hora atual do servidor.

SELECT CURRENT_TIMESTAMP();

Figura 4: Data e hora atual do servidor e hora formatada

Funç�o TIME()

Podemos usar essa funç�o para extrair somente a hora de um campo do tipo timestamp (�2012-08-23 20:53:32�). Para esse exemplo vou usar a funç�o CURRENT_TIMESTAMP() para retornar data e hora atual do servidor.

Listagem 4: Instruç�o para retornar somente hora

SELECT TIME(CURRENT_TIMESTAMP);

Figura 5: Hora atual do servidor, extra�da usando a funç�o TIME()

Funç�o SEC_TO_TIME()

Essa funç�o recebe um par�metro do tipo inteiro que teoricamente representaria os segundos e retorna um valor convertido em horas, minutos e segundos como um valor do tipo �Time�. Nesse exemplo vou passar o valor 1000 como par�metro.

Listagem 5: Instruç�o para convers�o de valor em tipo time.

SELECT SEC_TO_TIME(1000);

Figura 6: Valor de retorno da convers�o de segundos para time

Funç�o TIME_TO_SEC()

Agora vamos fazer o caminho inverso ao demonstrado na funç�o anterior. Vamos converter um valor do tipo time que ser� passado com par�metro para segundos, usando a funç�o �TIME_TO_SEC()�. Para melhor entender essa convers�o vou usar o mesmo valor de retorno da funç�o �SEC_TO_TIME()�, �00:16:40�.

Listagem 6: Instruç�o para convers�o de valor em tipo time.

SELECT TIME_TO_SEC('00:16:40');

Figura 7: Valor de retorno da convers�o de time para segundos

Funç�o HOUR(), MINUTE() E SECOND()

Usando essas 3 funç�es podemos fragmentar um valor do tipo time sendo que: HOUR() retorna hora, MINUTE() retorna minuto e SECOND() retorna segundo. Nesse exemplo vou fragmentar em 3 valores (Hora, Minuto e Segundo) um valor do tipo time('12:30:34').

Listagem 7: Instruç�o para dividir em tr�s valores um valor time

SELECT HOUR('12:30:34') AS HORA, MINUTE('12:30:34') AS MINUTOS, SECOND('12:30:34') AS SEGUNDOS;

Figura 8: Hora dividida em tr�s campos (HORA, MINUTO E SEGUNDO)

Funç�o TIMEDIFF()

Com a funç�o �TIMEDIFF()� podemos encontrar a diferença entre os 2 valores do tipo time que s�o passados como par�metro, ou seja, essa funç�o retorna o resultado da subtraç�o entre os par�metros. Muito semelhante � funç�o �DATEDIFF()� que retorna a diferença entre 2 datas.

Listagem 8: Instruç�o para retornar a diferença entre dois valores time

SELECT TIMEDIFF('12:35:34', '12:30:46');

Figura 9: Diferença entre os valores passados como par�metros

Bom pessoal, demonstrei nesse artigo algumas das funç�es para manipular valores do tipo time que o MySQL oferece. Para o leitor que tiver a curiosidade de conhecer todas ou a maioria, visite o site. Lembrado que esse artigo foi baseado no manual da vers�o 5.5 do MySQL, em vers�es anteriores existe a possibilidade de algumas dessas funç�es n�o funcionarem.

Sugiro ainda, a quem possa interessar, a leitura deste outro artigo no qual abordei as funç�es de manipulaç�o de datas no MySQL.

Espero que tenham apreciado e at� a pr�xima.

Caso suja alguma d�vida fiquem � vontade tamb�m para usar a seç�o de coment�rios.

Abraços a todos!

" target="_blank" title="Curso de MySQL Completo">MySQL oferece. Para o leitor que tiver a curiosidade de conhecer todas ou a maioria, visite o site. Lembrado que esse artigo foi baseado no manual da vers�o 5.5 do MySQL, em vers�es anteriores existe a possibilidade de algumas dessas funç�es n�o funcionarem.