Este artigo é uma continuação da 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 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!