Bagikan melalui

EOMONTH (T-SQL)

  • Artikel

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform 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

Sintaksis

EOMONTH ( start_date [ , month_to_add ] )

Catatan

Untuk melihat sintaks Transact-SQL untuk SQL Server 2014 (12.x) dan versi yang lebih lama, lihat Dokumentasi versi sebelumnya.

Argumen

Tanggal_mulai

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 adalah hasil yang ditetapkan.

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 adalah hasil yang ditetapkan.

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 adalah hasil yang ditetapkan.

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

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

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

Konten terkait