Between

Dadas duas datas ou duas horas quaisquer, o tube between devolve um número inteiro correspondente ao intervalo que se passou entre as duas, segundo uma unidade de medida temporal especificada (days, hours, minutes, etc).

Formato:

Copy
between(info1, info2, unit)

Parâmetros:

• info1: valor inicial, que pode ser uma data ou hora, uma variável do tipo Date ou Time ou, ainda, um tube que retorne data ou hora (como today e curTime).
• info2: valor final, que deve ser da mesma natureza (data ou hora) que o valor inicial.
• unit: especificação da unidade de medida. Pode ser: "years", "year" ou "y"; "months" ou "month"; "days", "day" ou "d"; "hours", "hour" ou "h"; "minutes", "minute" ou "m"; "seconds", "second" ou "s".

Retorno:

Retorna um número inteiro correspondente ao tempo decorrido de info1 até info2, segundo a unidade de medida especificada.

Exemplos:

1. Between com data/hora. Podemos comparar uma variável com uma data ou hora fixa.

Copy
print "Mesmo que o horário oficial para almoço seja às 12:00, o empregado costumava sair para almoçar às " & <saidaParaAlmoço> & ", ou seja, " & between(<saidaParaAlmoço>, "12:00", "minutes") & " minutos antes do horário determinado pela empresa."

2. Between com variáveis. Podemos também comparar duas variáveis. Por dar um retorno inteiro, pode ser comparado e operado com outros valores numéricos. Nesse exemplo, é interessante notar que o resultado da combinação de tubes é a aparição ou não de um determinado texto.

Copy
if (between(<dataRecebimentoProduto>, <dataArrependimento>, "days") > 7) {
    print "Quando o consumidor optou por exercer o seu direito de arrependimento, o prazo legal para seu exercício já havia transcorrido." 
}

3. Between com today. Por fim, podemos comparar uma variável com uma data ou hora retornada por um tube (como today ou curTime).

Copy
print "Já se passaram " & between(<dataCelebracaoContrato>, today(), "months") & " meses desde a celebração do contrato."