Bagikan melalui


Fungsi Tanggal dan Waktu

Penyedia Data .NET Framework untuk SQL Server (SqlClient) menyediakan fungsi tanggal dan waktu yang melakukan operasi pada System.DateTime nilai input dan mengembalikan sebuah string hasil, sebuah nilai numerik, atau sebuah System.DateTime nilai. Fungsi-fungsi ini berada di namespace layanan SqlServer, yang tersedia saat Anda menggunakan SqlClient. Properti namespace penyedia memungkinkan Entity Framework untuk menemukan awalan mana yang digunakan oleh penyedia ini untuk elemen spesifik, seperti jenis dan fungsi. Tabel berikut ini memperlihatkan fungsi tanggal dan waktu SqlClient.

Fungsi Deskripsi
DATEADD(datepart, number, date) Mengembalikan nilai DateTime baru yang didasarkan pada penambahan interval ke tanggal yang ditentukan.

Argumen

datepart: Sebuah String yang mewakili bagian tanggal untuk mengembalikan nilai baru.

number: Nilai Int32, Int64, Decimal, atau Double yang digunakan untuk meningkatkan datepart.

date: Ekspresi yang mengembalikan DateTime, atau DateTimeOffset, atau Time dengan presisi = [0-7], atau string karakter dalam format tanggal.

Nilai pengembalian

Nilai baru DateTime, atau DateTimeOffset, atau Time dengan tingkat presisi [0-7].

Contoh

SqlServer.DATEADD('day', 22, cast('6/9/2006' as DateTime))
DATEDIFF(datepart,startdate,enddate) Mengembalikan jumlah batas tanggal dan waktu yang dilewati antara dua tanggal yang ditentukan.

Argumen

datepart: String yang mewakili bagian dari tanggal untuk menghitung selisih.

startdate: Tanggal mulai untuk perhitungan adalah ekspresi yang mengembalikan DateTimenilai , atau DateTimeOffset, atau Time dengan presisi = [0-7], atau string karakter dalam format tanggal.

enddate: Tanggal akhir untuk perhitungan adalah ekspresi yang mengembalikan DateTimenilai , atau DateTimeOffset, atau Time dengan presisi = [0-7], atau string karakter dalam format tanggal.

Nilai pengembalian

Sebuah Int32.

Contoh

SqlServer.DATEDIFF('day', cast('6/9/2006' as DateTime),

cast('6/20/2006' as DateTime))
DATENAME(datepart, date) Mengembalikan string karakter yang mewakili bagian tanggal tertentu dari tanggal yang ditentukan.

Argumen

datepart: Sebuah String yang mewakili bagian tanggal untuk mengembalikan nilai baru.

date: Ekspresi yang menghasilkan nilai DateTime, atau DateTimeOffset, atau nilai Time dengan presisi antara [0-7], atau sebuah string karakter dalam format tanggal.

Nilai pengembalian

String karakter yang mewakili bagian tertentu dari tanggal yang ditentukan.

Contoh

SqlServer.DATENAME('year', cast('6/9/2006' as DateTime))
DATEPART(datepart, date) Mengembalikan bilangan bulat yang menunjukkan datepart yang ditentukan dari tanggal spesifik.

Argumen

datepart: Sebuah String yang mewakili bagian tanggal untuk mengembalikan nilai baru.

date: Ekspresi yang mengembalikan nilai DateTime,, DateTimeOffset,, atau Time dengan presisi = [0-7], atau string karakter dalam format tanggal.

Nilai pengembalian

Bagian tanggal yang ditentukan dari tanggal tersebut, sebagai Int32.

Contoh

SqlServer.DATEPART('year', cast('6/9/2006' as DateTime))
DAY(date) Mengembalikan hari dari tanggal yang ditentukan sebagai bilangan bulat.

Argumen

date:Ekspresi jenis DateTime atau DateTimeOffset dengan presisi = 0-7.

Nilai pengembalian

Hari tanggal yang ditentukan sebagai Int32.

Contoh

SqlServer.DAY(cast('6/9/2006' as DateTime))
GETDATE() Menghasilkan tanggal dan waktu saat ini dalam format internal SQL Server untuk nilai tanggal dan waktu.

Nilai pengembalian

Tanggal dan waktu sistem saat ini sebagai string yang diformat DateTime dengan presisi 3 angka desimal.

Contoh

SqlServer.GETDATE()
GETUTCDATE() Menghasilkan nilai tanggalwaktu dalam format UTC (Waktu Universal Terkoordinasi atau Waktu Rata-Rata Greenwich).

Nilai pengembalian

Nilai DateTime dengan presisi 3 dalam format UTC.

Contoh

SqlServer.GETUTCDATE()
MONTH(date) Mengembalikan bulan dari tanggal yang ditentukan sebagai bilangan bulat.

Argumen

date:Ekspresi jenis DateTime atau DateTimeOffset dengan presisi = 0-7.

Nilai pengembalian

Bulan pada tanggal yang telah ditentukan sebagai Int32.

Contoh

SqlServer.MONTH(cast('6/9/2006' as DateTime))
YEAR(date) Mengembalikan tahun dari tanggal yang ditentukan sebagai bilangan bulat.

Argumen

date:Ekspresi jenis DateTime atau DateTimeOffset dengan presisi = 0-7.

Nilai pengembalian

Tahun dari tanggal yang ditentukan sebagai Int32.

Contoh

SqlServer.YEAR(cast('6/9/2006' as DateTime))
SYSDATETIME() Mengembalikan nilai DateTime dengan ketepatan yang mencapai 7.

Nilai pengembalian

Nilai DateTime dengan presisi hingga 7.

Contoh

SqlServer.SYSDATETIME()
SYSUTCDATE() Menghasilkan nilai tanggalwaktu dalam format UTC (Waktu Universal Terkoordinasi atau Waktu Rata-Rata Greenwich).

Nilai pengembalian

Nilai DateTime dengan presisi = 7 dalam format UTC.

Contoh

SqlServer.SYSUTCDATE()
SYSDATETIMEOFFSET() Mengembalikan DateTimeOffset dengan presisi 7.

Nilai pengembalian

Nilai DateTimeOffset dengan presisi 7 dalam format UTC.

Contoh

SqlServer.SYSDATETIMEOFFSET()

Untuk informasi selengkapnya tentang fungsi tanggal dan waktu yang didukung SqlClient, lihat Jenis dan Fungsi Data Tanggal dan Waktu (Transact-SQL).

Lihat juga