sc_time_diff({datetime_01}, "Formato datetime_01", {datetime_02}, "Formato datetime_02")

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.

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).