IBM FileNet P8, Version 5.2.1            

addtimeunit

Essas funções retornam um horário ao incluir um número especificado de unidades de tempo em um horário.

A sintaxe é conforme a seguir:
  • addseconds(time_value, time_units)
  • addminutes(time_value, time_units)
  • addhours(time_value, time_units)
  • adddays(time_value, time_units)
  • addmonths(time_value, time_units)
  • addyears(time_value, time_units)
time_value
Uma expressão de tipo horário.
time_units

O número de unidades de tempo que representam a quantia de tempo a ser incluída em time_value. Por exemplo, para a função addseconds, esse parâmetro é o número de segundos a serem incluídos. Para calcular um tempo passado em relação a time_value, passe um número negativo para esse parâmetro.

Se você inserir um valor flutuante para esse parâmetro, como 5,4 ou 27,9, somente a parte de número inteiro do número será usada. Por exemplo, 5,4 torna-se 5.

O exemplo a seguir de uma chamada de função retorna um horário que é o número de horas especificado depois de entry_time:
addhours(Entry_time, num_hours)

Avaliação de addmonths e addyears

O algoritmo para as funções addmonths e addyears pode ser diferente da forma com que os cálculos comparativos são feitos em vários ambientes de desenvolvimento.

Para a função addmonths, a adição do número especificado de meses pode produzir, inicialmente, uma data além do término do novo mês. Neste caso, a função retornará o primeiro dia do próximo mês. Por exemplo, a expressão a seguir retornará 01/03/1997:
addmonths(convert("01/31/1997 12:00:00", time), 1)
As avaliações da função addyears são comparáveis. Por exemplo, a expressão a seguir retornará 01/03/2001:
addyears(convert("02/29/2000 12:00:00", time), 1)
O formato de hora inserido (neste caso, a data e hora completas) deve corresponder à máscara de data/hora no sistema de fluxo de trabalho. Para obter mais informações, consulte Máscaras de Data/Hora.


Last updated: March 2016
bpfe022.htm

© Copyright IBM Corporation 2016.