English
Español
RetornaDifDataHora
Retorna a diferença entre as datas e horas informadas, sendo que é considerado o conjunto data + hora e não informações individuais.
Sintaxe: RetornaDifDataHora(Data aDatIni, Numero aHorIni, Data aDatFim, Numero aHorFim, Numero End aDias, Numero End aHoras, Numero End aMinutos)
Parâmetros:Nome | Tipo | Descrição |
aDatIni | Numérico | Data inicial. |
aHorIni | Numérico | Hora inicial. |
aDatFim | Numérico | Data final. |
aHorFim | Numérico | Hora final. |
aDias | Numérico | Retorna a quantidade de dias existente entre as datas. |
aHoras | Numérico | Retorna a quantidade de horas existente entre as datas. |
aMinutos | Numérico | Retorna a quantidade de minutos existente entre as datas. |
<div class="Code"><p>/* Exemplos de parâmetros passados e retorno esperado */<br></br><br></br>Definir Data xData1;<br></br>Definir Data xData2;<br></br>Definir Data xHora1;<br></br>Definir Data xHora2;<br></br><br></br>/* ********* */<br></br>/* Exemplo 1 */<br></br>/* ********* */<br></br>MontaData(01,12,2005, xData1);<br></br>xHora1 = 480; /* 8:00 */<br></br>MontaData(20,02,2006, xData2);<br></br>xHora2 = 1080; /* 18:00 */<br></br><br></br>RetornaDifDataHora(xData1, xHora1, xData2, xHora2, xDias, xHoras, xMinutos);<br></br><br></br>/* Retorno esperado */<br></br>xDias = 81;<br></br>xHoras = 10; <br></br>xMinutos = 0;<br></br><br></br><br></br>/* ********* */<br></br>/* Exemplo 2 */<br></br>/* ********* */<br></br>MontaData(10,02,2006, xData1);<br></br>xHora1 = 1110; /* 18:30 */<br></br>MontaData(11,02,2006, xData2);<br></br>xHora2 = 480; /* 8:00 */<br></br><br></br>RetornaDifDataHora(xData1, xHora1, xData2, xHora2, xDias, xHoras, xMinutos);<br></br><br></br>/* Retorno esperado */<br></br>xDias = 0;<br></br>xHoras = 13;<br></br>xMinutos = 30;<br></br><br></br><br></br>/* ********* */<br></br>/* Exemplo 3 */<br></br>/* ********* */<br></br>MontaData(10,01,2006, xData1);<br></br>xHora1 = 0;<br></br>MontaData(20,02,2006, xData2);<br></br>xHora2 = 0;<br></br><br></br>RetornaDifDataHora(xData1, xHora1, xData2, xHora2, xDias, xHoras, xMinutos);<br></br><br></br>/* Retorno esperado */<br></br>xDias = 40;<br></br>xHoras = 0;<br></br>xMinutos = 0;<br></br><br></br>xMinutos = 0;<br></br>xMinutos = 0;<br></br><br></br><br></br>/* ********* */<br></br>/* Exemplo 4 */<br></br>/* ********* */<br></br>MontaData(10,01,2006, xData1);<br></br>xHora1 = 720;<br></br>MontaData(20,02,2006, xData2);<br></br>xHora2 = 720;<br></br><br></br>RetornaDifDataHora(xData1, xHora1, xData2, xHora2, xDias, xHoras, xMinutos);<br></br><br></br>/* Retorno esperado */<br></br>xDias = 41;<br></br>xHoras = 0;<br></br>xMinutos = 0;</p></div>
Utilização: Regras do sistema e Gerador de Relatórios.
English
Español
