# 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:

Argumentos AddMonths

| 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:

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' |