sc_time_diff({datetime_01}, "Formato datetime_01", {datetime_02}, "Formato datetime_02");
Essa macro calcula a diferença entre dois valores do tipo time/datetime e retorna o resultado em formato de horas.
A estrutura do retorno é no formato de array, onde os índices [0], [1] e [2] contém horas, minutos e segundos, respectivamente.
Parâmetro
|
Descrição
|
datetime_01
|
Valor ou variável contendo o primeiro datetime/time.
|
Formato datetime_01
|
Valor ou variável contendo o formato no qual está armazenado o datetime_01/time.
|
datetime_02
|
Valor ou variável contendo o segundo datetime/time.
|
Formato datetime_02
|
Valor ou variável contendo o formato no qual está armazenado o datetime_02/time.
|
Ex. 1: Formato geral
{diferencas} = sc_time_diff({datetime_01}, "Formato datetime_01", {datetime_02}, "Formato datetime_02");
{dif_horas} = {diferencas[0]};
{dif_minutos} = {diferencas[1]};
{dif_segundos} = {diferencas[2]};
Ex. 2: Retornando valores positivos
{diferencas} = sc_time_diff("2012-07-25 05:33:45", "yyyy-mm-dd hh:ii:ss", "2012-07-21 15:22:57", "yyyy-mm-dd hh:ii:ss");
{diferencas[0]} seria igual a 86 (horas)
{diferencas[1]} seria igual a 10 (minutos)
{diferencas[2]} seria igual a 48 (segundos).
Ex. 3: Retornando valores negativos
{diferencas} = sc_time_diff("2012-07-21 15:22:57", "yyyy-mm-dd hh:ii:ss", "2012-07-25 05:33:45", "yyyy-mm-dd hh:ii:ss");
{diferencas[0]} seria igual a -86 (horas)
{diferencas[1]} seria igual a -10 (minutos)
{diferencas[2]} seria igual a -48 (segundos).
Ex. 4: Considerando apenas formato de horas - Retorno positivo
{diferencas} = sc_time_diff("18:14:55", "hh:ii:ss", "10:55:22", "hh:ii:ss");
{diferencas[0]} seria igual a 7 (horas)
{diferencas[1]} seria igual a 19 (minutos)
{diferencas[2]} seria igual a 33 (segundos).
Ex. 5: Considerando apenas formato de horas - Retorno negativo
{diferencas} = sc_time_diff ("10:55:22", "hh:ii:ss", "18:14:55", "hh:ii:ss");
{diferencas[0]} seria igual a -7 (horas)
{diferencas[1]} seria igual a -19 (minutos)
{diferencas[2]} seria igual a -33 (segundos).
|