Fungsi ADD_MONTHS - AWS Clean Rooms
SintaksisArgumenJenis pengembalianContoh

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Fungsi ADD_MONTHS

ADD_MONTHS menambahkan jumlah bulan yang ditentukan ke nilai atau ekspresi tanggal atau stempel waktu. DATEADDFungsi ini menyediakan fungsionalitas serupa.

Sintaks

ADD_MONTHS( {date | timestamp}, integer)

Argumen

tanggal | stempel waktu

Kolom tanggal atau stempel waktu atau ekspresi yang secara implisit mengkonversi ke tanggal atau stempel waktu. Jika tanggal adalah hari terakhir bulan itu, atau jika bulan yang dihasilkan lebih pendek, fungsi mengembalikan hari terakhir bulan dalam hasilnya. Untuk tanggal lain, hasilnya berisi nomor hari yang sama dengan ekspresi tanggal.

bilangan bulat

Sebuah bilangan bulat positif atau negatif. Gunakan angka negatif untuk mengurangi bulan dari tanggal.

Jenis pengembalian

TIMESTAMP

Contoh

Query berikut menggunakan fungsi ADD_MONTHS di dalam fungsi TRUNC. Fungsi TRUNC menghapus waktu hari dari hasil ADD_MONTHS. Fungsi ADD_MONTHS menambahkan 12 bulan ke setiap nilai dari kolom CALDATE. 

select distinct trunc(add_months(caldate, 12)) as calplus12,
trunc(caldate) as cal
from date
order by 1 asc;

 calplus12  |    cal
------------+------------
 2009-01-01 | 2008-01-01
 2009-01-02 | 2008-01-02
 2009-01-03 | 2008-01-03
...
(365 rows)

Contoh berikut menunjukkan perilaku ketika fungsi ADD_MONTHS beroperasi pada tanggal dengan bulan yang memiliki jumlah hari yang berbeda. 

select add_months('2008-03-31',1);

add_months
---------------------
2008-04-30 00:00:00
(1 row)

select add_months('2008-04-30',1);

add_months
---------------------
2008-05-31 00:00:00
(1 row)