No banco de dados Oracle, o
ADD_MONTHS() A função adiciona um determinado número de meses a uma data e retorna o resultado. Sintaxe
A sintaxe fica assim:
ADD_MONTHS(date, integer)Onde
date pode ser um valor de data e hora ou qualquer valor que possa ser convertido implicitamente em DATE . O
integer argumento pode ser um inteiro ou qualquer valor que possa ser convertido implicitamente em um inteiro. O tipo de retorno é sempre
DATE , independentemente do tipo de dados de date . Exemplo
Aqui está um exemplo:
SELECT ADD_MONTHS(DATE '2020-01-01', 3)
FROM DUAL;Resultado:
01/APR/20
Este exemplo exibe a data com base no valor do
NLS_DATE_FORMAT do meu sistema parâmetro (que atualmente é DD/MON/RR ). Podemos alterar este parâmetro ou usar uma função como TO_CHAR() para retornar o resultado em um formato diferente. Exemplo:
SELECT TO_CHAR(ADD_MONTHS(DATE '2020-01-01', 3), 'YYYY-MM-DD')
FROM DUAL;Resultado:
2020-04-01
Subtrair Meses
Para subtrair meses de uma data, use um valor negativo para o segundo argumento.
Exemplo:
SELECT ADD_MONTHS(DATE '2020-01-01', -3)
FROM DUAL;Resultado:
01/OCT/19
Passando vários formatos de data
A data pode ser fornecida em vários formatos, desde que resolva para uma data:
SELECT ADD_MONTHS('01 Jan 2020', 3)
FROM DUAL;Resultado:
01/APR/20
Mas passar um que não pode ser resolvido resulta em um erro:
SELECT ADD_MONTHS('Jan 01 2020', 3)
FROM DUAL;Resultado:
Error starting at line : 1 in command -
SELECT ADD_MONTHS('Jan 01 2020', 3)
FROM DUAL
Error report -
ORA-01858: a non-numeric character was found where a numeric was expected No entanto, isso pode depender do valor do
NLS_DATE_FORMAT parâmetro. Se alterarmos este parâmetro:ALTER SESSION SET NLS_DATE_FORMAT = "Mon DD RR";
SELECT VALUE
FROM V$NLS_PARAMETERS
WHERE PARAMETER = 'NLS_DATE_FORMAT';Resultado:
VALUE ____________ Mon DD RR
E, em seguida, execute a consulta novamente:
SELECT ADD_MONTHS('Jan 01 2020', 3)
FROM DUAL;Resultado:
Apr 01 20
Não recebemos mais o erro.
Argumentos nulos
Passando uma data de
null retorna null :SET NULL 'null';
SELECT ADD_MONTHS(null, 1)
FROM DUAL;Resultado:
null
Mas passar null para o segundo argumento resulta em um erro:
SELECT ADD_MONTHS('2020-01-01', null)
FROM DUAL;Resultado:
Error starting at line : 1 in command -
SELECT ADD_MONTHS('2020-01-01', null)
FROM DUAL
Error report -
ORA-01843: not a valid month Observe que, por padrão, SQLcl e SQL*Plus retornam um espaço em branco sempre que
null ocorre como resultado de um SQL SELECT demonstração. No entanto, você pode usar
SET NULL para especificar uma string diferente a ser retornada. No exemplo acima, especifiquei que a string null deve ser devolvido. Número inválido de argumentos
Passar um número inválido de argumentos resulta em um erro:
SELECT ADD_MONTHS(3)
FROM DUAL;Resultado:
Error starting at line : 1 in command - SELECT ADD_MONTHS(3) FROM DUAL Error at Command Line : 1 Column : 8 Error report - SQL Error: ORA-00909: invalid number of arguments 00909. 00000 - "invalid number of arguments" *Cause: *Action:
