Bagikan melalui


EOMONTH (T-SQL)

Berlaku untuk: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Fungsi ini mengembalikan hari terakhir dalam sebulan yang berisi tanggal tertentu, dengan offset opsional.

Tip

Di SQL Server 2022 (16.x) dan versi yang lebih baru, Anda dapat menggunakan DATETRUNC untuk menghitung awal bulan.

Konvensi sintaks transact-SQL

Sintaks

EOMONTH ( start_date [ , month_to_add ] )

Argumen

start_date

Ekspresi tanggal yang menentukan tanggal untuk mengembalikan hari terakhir dalam sebulan.

month_to_add

Ekspresi bilangan bulat opsional yang menentukan jumlah bulan yang akan ditambahkan ke start_date.

Jika argumen month_to_add memiliki nilai, maka EOMONTH menambahkan jumlah bulan yang ditentukan ke start_date, lalu mengembalikan hari terakhir bulan untuk tanggal yang dihasilkan. Jika penambahan ini meluapkan rentang tanggal yang valid, maka EOMONTH menimbulkan kesalahan.

Jenis yang dikembalikan

date

Keterangan

Fungsi ini EOMONTH dapat jarak jauh ke instans yang menjalankan SQL Server 2012 (11.x) dan versi yang lebih baru. Ini tidak dapat jarak jauh ke instans dengan versi sebelum SQL Server 2012 (11.x).

Contoh

J. EOMONTH dengan jenis tanggalwaktu eksplisit

DECLARE @date DATETIME = '12/1/2024';

SELECT EOMONTH(@date) AS Result;
GO

Berikut set hasilnya.

Result
------------
2024-12-31

B. EOMONTH dengan parameter string dan konversi implisit

DECLARE @date VARCHAR(255) = '12/1/2024';

SELECT EOMONTH(@date) AS Result;
GO

Berikut set hasilnya.

Result
------------
2024-12-31

C. EOMONTH dengan dan tanpa parameter month_to_add

Nilai yang ditunjukkan dalam tataan hasil ini mencerminkan tanggal eksekusi antara dan termasuk 12/01/2024 dan 12/31/2024.

DECLARE @date DATETIME = '2024-12-31';

SELECT EOMONTH(@date) AS 'This Month';
SELECT EOMONTH(@date, 1) AS 'Next Month';
SELECT EOMONTH(@date, -1) AS 'Last Month';
GO

Berikut set hasilnya.

This Month
-----------------------
2024-12-31

Next Month
-----------------------
2025-01-31

Last Month
-----------------------
2024-11-30