Comando time.calculate

O comando time.calculate é utilizado para realizar calculo de tempo com suporte a adição, subtração e diferença.

Parâmetros

1. date [string]
   Data que será alterada ou utilizada como comparação no caso da operação diferença.
2. greaterdate [string]
   Data maior que será usada na comparação no caso de operação diferença. Para as operações de mais e menos, essa variável não é utilizada, porém não deve ser passado um valor em branco, pois isso pode causar um POSXML Error.
3. operation [string]
   Tipo da operação, pode ser: sum, less ou difference.
4. type [string]
   Tipo de tempo a ser calculado: years, months, days, hours, minutes ou seconds.
   Para a operação de diferença essa variável não é utilizada, porém não deve ser passado um valor em branco, pois isso pode causar um POSXML Error.
5. value [integer]
   Valor a ser somado ou subtraído (somente para operações sum e less).
6. variablereturn [integer]
   Caso a operação seja diferença, é retornado o valor da diferença. Caso seja operação mais ou menos retorna:
   0: Sucesso
   -1: Erro.

Exemplo

---

No exemplo acima, existem três operações: difference, sum e less.

A primeira operação feita é difference, nesta operação a data contida na variável sDate1 é comparada com a data contida na variável sDate2, e a diferença entre as duas datas é retornada em segundos para o parâmetro variablereturn.

A segunda operação feita é sum, nesta operação, é somado 10 horas na data contida em sDate1. Caso a operação seja executada com successo, o parâmetro variablereturn retornará 0, e, a data contida em sDate1 vai estar com 10 horas incrementadas.

A terceira operação feita é less, nesta operação, é subtraido 10 minutos na data contida em sDate1. Caso a operação seja executada com succeso, o parâmetro variablereturn retornará 0, e, a data contida em sDate1 vai estar com menos 10 minutos.