Como converter e formatar a exibição de horas decimais com SQL Server - parte 2
Autor: Vladimir Rech | Publicado: 2015-08-14T23:17:00-03:00





   Este artigo é uma continuação da 
      <a href="http://vladimirrech.blogspot.com.br/2015/08/como-converter-e-formatar-exibicao-de.html" 
   target="blank">primeira parte  onde são explicados os passos para
      a conversão de horas no formato decimal para o padrão para horas (HH:MM).
   
   O objetivo é demonstrar como criar uma função do SQL Server para representar o tempo corrido
      em horas e minutos no formato correto uma vez tendo armazenado este valor em formato decimal
   para fins de cálculo. Eu recomendo a leitura do artigo acima para que se tenha uma visão
   geral do assunto e o seu pano de fundo.
   
   Inicialmente pode parecer um trabalho desnecessário criar uma função específica para esta
   finalidade principalmente por que a função 
   
   CONVERT possui vários recursos que possibilitam realizar a tarefa acima, mas, quando
   se começa a explorar as possibilidades, percebe-se que o trabalho de achar o formato
   correto dos parâmetros e o número de cálculos que se tem de executar incluindo conversões
   em cascata, chamadas de diversas funções e operações diversas com datas é praticamente o mesmo
   (ou maior até) do que criar uma função apropriada para esta finalidade.
   
   Além disso, o propósito é também demonstrar a criação de funções de usuário com o SQL Server
    e usar estas em consultas.
    
   Criando a função para conversão
   Desde versões mais antigas o SQL Server (assim como demais bancos de dados) era fornecido com
   funções para auxiliar durante as consultas. Atualmente existe um número muito grande (que pode
   ser conferido neste 
   link). Além de sua grande utilidade é possível estender as funcionalidades da linguagem
   SQL com funções definidas pelo usuário ou User Defined Functions. Novamente, a 
   
   documentação oficial pode ser de grande utilidade para a criação destas.
   Basicamente você pode criar uma função com dois tipos de retorno:
   
    Valores simples ou scalar values que é o termo usado pela documentação oficial.
    Tabelas ou conjunto de colunas e linhas que correspondam a um resultado de uma consulta.
   
   No exemplo proposto será criada uma função do tipo scalar que precisa receber como
     parâmetro um número do tipo decimal correspondendo ao tempo corrido e retorna um valor do tipo
   string representando as horas e minutos da duração convertidos.
   O corpo desta função está representado a seguir.



create function dbo.DecimalToHour(@elapsed_hours as decimal(8,2)) returns varchar(8)
as
begin
 declare @sHour as varchar(4) = convert(varchar(4), convert(integer, @elapsed_hours))
 declare @sMin as varchar(2) = convert(varchar(2), convert(integer, @elapsed_hours * 60 % 60))
 return replicate('0', 2 - len(@sHour)) + @sHour + ':' + replicate('0', 2 - len(@sMin)) + @sMin;
end
go



   O primeiro ponto a observar é o cabeçalho da função. Observe que foi incluida a palavra reservada
   
   "dbo" ligada ao nome. Isto tem, no exemplo, o objetivo de indentificar que a função
   é de usuário e não uma função nativa do banco.
   Continuando com o cabeçalho entre parênteses foi nomeado o parâmetro que é recebido para a execução do cálculo. Este segue
   o padrão da criação de variáveis do SQL Server. O tipo decimal foi o que melhor se adequou
   à função. A definição da escala e da precisão também são necessárias para este exemplo. Neste caso
   somente uma variável foi usada, mas, como você pode esperar, várias podem ser definidas.
   Finalizando a declaração da função deve ser colocado o tipo de dado de retorno correspondente aos tipos
   suportados pelo SQL Server. No exemplo da conversão foi escolhido o tipo varchar com um tamanho
   máximo de oito posições.
   O corpo da função é desenvolvido dentro de um bloco
   
   as ... begin ... end
   
   e a última instrução deve ser obrigatoriamente ser um
   
   return
   .
   A primeira linha declara uma variável para armazenar a parte correspondente às horas. Neste passo basta
   apenas usar a conversão do tipo de dados decimal para integer que o valor é truncado sem
   arredondamentos e aí está a necessidade de se seguir exatamente os tipos de dados e tamanhos que estão
   demonstrados nesta função. Esta função prevè a exibição de horas de duração com até quatro casas, para
   durações maiores é necessário alterar o tamanho definido em varchar.
   Na sequência é feita a conversão dos minutos usando o operador de módulo do SQL Server. Esta operação
   foi explicada em detalhes no 
   <a href="http://vladimirrech.blogspot.com.br/2015/08/como-converter-e-formatar-exibicao-de.html" 
     target="blank">post anterior então aqui a única ação adicional foi a conversão para o formato
   apropriado de retorno.
   Para o retorno as duas variáveis são concatenadas e formatadas com zeros à direita através da
   função replicate. Note que está sendo calculado o número de repetições considerando apenas
   duas posições.
   Demonstrando a utilização
   A forma mais rápida de testar o funcionamento é após criar a função em seu banco de dados executar uma
   instrução como a que está demonstrada no exemplo abaixo.


select dbo.DecimalToHour(23.5);



   Esta instrução vai gerar o resultado da figura abaixo.   
   Para um exemplo completo vamos considerar uma tabela fictícia e bem simples para
   que armazene quantas horas cada desenvolvedor trabalhou em um projeto. Esta tabela
   proposta pode ter a estrutura demonstrada a seguir.
   
   
   Considere ainda os dados da próxima figura como pertencentes a esta tabela.

   A consulta a seguir demonstra como fica uma consulta usando uma função definida pelo usuário,
    é importante observar que foi colocado o nome do schema "dbo" para que a função seja corretamente
    acessada.
   
   
   

select DeveloperName, ProjectName, dbo.DecimalToHour(WorkedHours) as WorkedTime
from Projects
order by ProjectName
rollback
go




 Estes resultados podem variar dependendo dos dados que você inserir. É possível aperfeiçoar
    esta função ainda para fazer outros cálculos como retornar o número de dias também. Fica a
    dica para você explorar. Até a próxima!