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.