SET DATEFORMAT (Transact-SQL)

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsSistem Platform Analitik (PDW)Titik akhir analitik SQL di Microsoft FabricGudang di Microsoft FabricDatabase SQL di Microsoft Fabric

Mengatur urutan bagian tanggal bulan, hari, dan tahun untuk menginterpretasikan string karakter tanggal. String ini berjenis tanggal, smalldatetime, datetime, datetime2, atau datetimeoffset.

Untuk gambaran umum semua jenis dan fungsi data tanggal dan waktu Transact-SQL, lihat Jenis dan Fungsi Data Tanggal dan Waktu (Transact-SQL).

Konvensi sintaks transact-SQL

Sintaks

SET DATEFORMAT { format | @format_var }   

Argumen

Format | @format_var
Adalah urutan bagian tanggal. Parameter yang valid adalah mdy, dmy, ymd, ydm, myd, dan dym. Dapat berupa Unicode atau kumpulan karakter byte ganda (DBCS) yang dikonversi ke Unicode. Default bahasa Inggris A.S. adalah mdy. Untuk default DATEFORMAT semua bahasa pendukung, lihat sp_helplanguage (Transact-SQL).

Keterangan

DATEFORMAT ydm tidak didukung untuk tipe data date, datetime2, dan datetimeoffset.

Pengaturan DATEFORMAT dapat menafsirkan string karakter secara berbeda untuk jenis data tanggal, tergantung pada format stringnya. Misalnya, interpretasi datetime dan smalldatetime mungkin tidak cocok dengan tanggal, datetime2, atau datetimeoffset. DATEFORMAT memengaruhi interpretasi string karakter saat dikonversi ke nilai tanggal untuk database. Ini tidak memengaruhi tampilan nilai tipe data tanggal, atau format penyimpanannya dalam database.

Beberapa format string karakter, misalnya ISO 8601, ditafsirkan secara independen dari DATEFORMAT pengaturan.

Pengaturan SET DATEFORMAT diatur pada waktu eksekusi atau run time dan bukan pada waktu penguraian.

SET DATEFORMAT mengganti pengaturan SET LANGUAGEformat tanggal implisit .

Izin

Memerlukan keanggotaan dalam peran publik .

Contoh

Contoh berikut menggunakan string tanggal yang berbeda sebagai input dalam sesi dengan pengaturan yang sama DATEFORMAT .

-- Set date format to day/month/year.  
SET DATEFORMAT dmy;  
GO  
DECLARE @datevar DATETIME2 = '31/12/2008 09:01:01.1234567';  
SELECT @datevar;  
GO  
-- Result: 2008-12-31 09:01:01.123  
SET DATEFORMAT dmy;  
GO  
DECLARE @datevar DATETIME2 = '12/31/2008 09:01:01.1234567';  
SELECT @datevar;  
GO  
-- Result: Msg 241: Conversion failed when converting date and/or time -- from character string.  
  
GO  

Lihat Juga

SET Pernyataan (Transact-SQL)