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:
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.addyears(convert("02/29/2000 12:00:00", time), 1)