addmonths – função de script e gráfico
Essa função retorna a data que ocorre n meses depois de startdate ou, se n for negativo, a data que ocorre n meses antes de startdate.
Sintaxe:
AddMonths(startdate, n , [ , mode])
Tipo de dados de retorno: dual
Argumentos:
| Argumento | Descrição |
|---|---|
| startdate | A data de início como um carimbo de data/hora, como “12/10/2012”. |
| n | Número de meses como um número inteiro positivo ou negativo. |
| mode | mode especifica se o mês é adicionado em relação ao início ou ao final do mês. Se a data de entrada for 28 ou acima e mode for definido como 1, a função retornará uma data que está à mesma distância do final do mês que a data de entrada. O modo padrão é 0. |
Exemplos e resultados:
| Exemplo | Resultado |
|---|---|
| addmonths ('2003-01-29',3) | retorna '2003-04-29' |
| addmonths ('2003-01-29',3,0) | retorna '2003-04-29' |
| addmonths ('2003-01-29',3,1) | retorna '2003-04-28' |
| addmonths ('2003-01-29',1,0) | retorna '2003-02-28' |
| addmonths ('2003-01-29',1,1) | retorna '2003-02-26' |
| addmonths ('2003-02-28',1,0) | retorna '2003-03-28' |
| addmonths ('2003-02-28',1,1) | retorna '2003-03-31' |