Harfiah (Entity SQL)
Topik ini menjelaskan dukungan Entity SQL untuk harfiah.
Null
Harfiah null digunakan untuk mewakili nilai null untuk jenis apa pun. Harfiah null kompatibel dengan jenis apa pun.
Null yang diketik dapat dibuat oleh transmisikan di atas harfiah null. Untuk informasi selengkapnya, lihat CAST.
Untuk aturan tentang di mana harfiah null mengambang dapat digunakan secara gratis, lihat Harfiah null dan Inferensi Jenis.
Boolean
Harfiah Boolean diwakili oleh kata kunci true dan false.
Bilangan bulat
Harfiah bilangan bulat dapat berjenis Int32 atau Int64. Harfiah Int32 adalah serangkaian karakter numerik. Harfiah Int64 adalah serangkaian karakter numerik yang diikuti oleh huruf besar L.
Decimal
Angka titik tetap (desimal) adalah serangkaian karakter numerik, titik (.) dan serangkaian karakter numerik lainnya yang diikuti oleh huruf besar "M".
Mengambang, Ganda
Angka titik mengambang presisi ganda adalah serangkaian karakter numerik, titik (.) dan serangkaian karakter numerik lainnya yang mungkin diikuti oleh eksponen. Angka titik mengambang presisi tunggal (atau float) adalah sintaksis angka titik mengambang presisi ganda yang diikuti dengan huruf kecil f.
String
String adalah serangkaian karakter yang diapit oleh tanda petik. Tanda kutip dapat berupa tanda kutip tunggal (') atau tanda kutip ganda ("). Harfiah string karakter dapat berupa Unicode atau non-Unicode. Untuk mendeklarasikan harfiah string karakter sebagai Unicode, awali harfiah dengan huruf besar "N". Standarnya adalah harfiah string karakter non-Unicode. Tidak boleh ada spasi antara N dan payload harfiah string, dan N harus merupakan huruf besar.
'hello' -- non-Unicode character string literal
N'hello' -- Unicode character string literal
"x"
N"This is a string!"
'so is THIS'
DateTime
Harfiah tanggalwaktu adalah independen pada lokal dan terdiri dari bagian tanggal dan waktu. Kedua tanggal dan waktu adalah wajib dan tidak ada nilai default.
Bagian tanggal harus memiliki format: YYYY-MM-DD, dengan YYYY adalah nilai tahun empat digit antara 0001 dan 9999, MM adalah bulan antara 1 dan 12 dan DD adalah nilai hari yang berlaku untuk bulan tertentu MM.
Bagian waktu harus memiliki format: HH:MM[:SS[.fffffff]], yang mana HH adalah nilai jam antara 0 dan 23, MM adalah nilai menit antara 0 dan 59, SS adalah nilai kedua antara 0 dan 59 dan fffffff adalah nilai pecahan kedua antara 0 dan 9999999. Semua rentang nilai sudah termasuk. Detik pecahan bersifat opsional. Detik bersifat opsional kecuali detik pecahan yang ditentukan; dalam hal ini, detik diperlukan. Ketika detik atau pecahan detik tidak ditentukan, nilai default nol akan digunakan sebagai gantinya.
Mungkin ada sejumlah spasi antara simbol TANGGALAWKTU dan payload harfiah, tetapi tidak ada baris baru.
DATETIME'2006-10-1 23:11'
DATETIME'2006-12-25 01:01:00.0000000' -- same as DATETIME'2006-12-25 01:01'
Waktu
Harfiah waktu adalah independen pada lokal dan hanya terdiri dari bagian waktu. Bagian waktu adalah wajib dan tidak ada nilai default. Formatnya harus HH:MM[:SS[.fffffff]], di mana HH adalah nilai jam antara 0 dan 23, MM adalah nilai menit antara 0 dan 59, SS adalah nilai kedua antara 0 dan 59, dan ffffff adalah nilai pecahan kedua antara 0 dan 9999999. Semua rentang nilai sudah termasuk. Detik pecahan bersifat opsional. Detik bersifat opsional kecuali detik pecahan yang ditentukan; dalam hal ini, detik diperlukan. Ketika detik atau pecahan tidak ditentukan, nilai default nol akan digunakan sebagai gantinya.
Mungkin ada sejumlah spasi antara simbol WAKTU dan payload harfiah, tetapi tidak ada baris baru.
TIME'23:11'
TIME'01:01:00.1234567'
DateTimeOffset
Harfiah datetimeoffset bersifat independen pada lokal dan terdiri dari bagian tanggal, bagian waktu, dan bagian offset. Semua tanggal, waktu, dan bagian offset adalah wajib dan tidak ada nilai default. Bagian tanggal harus memiliki format YYYY-MM-DD, di mana YYYY adalah nilai tahun empat digit antara 0001 dan 9999, MM adalah bulan antara 1 dan 12, dan DD adalah nilai hari yang berlaku untuk bulan tertentu. Bagian waktu harus memiliki format HH:MM[:SS[.fffffff]], di mana HH adalah nilai jam antara 0 dan 23, MM adalah nilai menit antara 0 dan 59, SS adalah nilai kedua antara 0 dan 59, dan ffffff adalah nilai pecahan kedua antara 0 dan 9999999. Semua rentang nilai sudah termasuk. Detik pecahan bersifat opsional. Detik bersifat opsional kecuali detik pecahan yang ditentukan; dalam hal ini, detik diperlukan. Ketika detik atau pecahan tidak ditentukan, nilai default nol akan digunakan sebagai gantinya. Bagian offset harus memiliki format {+|-}HH:MM, di mana HH dan MM memiliki arti yang sama seperti pada bagian waktu. Namun, rentang offset, harus berada di antara -14:00 dan + 14:00
Mungkin ada sejumlah spasi antara simbol DATETIMEOFFSET dan payload harfiah, tetapi tidak ada baris baru.
DATETIMEOFFSET'2006-10-1 23:11 +02:00'
DATETIMEOFFSET'2006-12-25 01:01:00.0000000 -08:30'
Catatan
Nilai harfiah Entity SQL yang valid dapat berada di luar rentang yang didukung untuk CLR atau sumber data. Hal ini dapat mengakibatkan pengecualian
Biner
Harfiah string biner adalah urutan digit heksadesimal yang dibatasi oleh tanda kutip tunggal mengikuti biner kata kunci atau simbol pintasan X atau x. Simbol pintasan X tidak peka huruf besar-kecil. Nol atau lebih spasi diperbolehkan antara kata kunci binary dan nilai string biner.
Karakter heksadesimal juga tidak peka huruf besar/kecil. Jika harfiah terdiri dari jumlah digit heksadesimal ganjil, harfiah akan disejajarkan dengan digit heksadesimal genap berikutnya dengan mengawali harfiah dengan digit nol heksadesimal. Tidak ada batasan formal pada ukuran string biner.
Binary'00ffaabb'
X'ABCabc'
BINARY '0f0f0f0F0F0F0F0F0F0F'
X'' –- empty binary string
Guid
Harfiah GUID mewakili pengidentifikasi unik global. Ini adalah urutan yang dibentuk oleh kata kunci GUID diikuti oleh digit heksadesimal dalam bentuk yang dikenal sebagai format registri: 8-4-4-4-12 diapit oleh tanda kutip tunggal. Digit heksadesimal tidak peka huruf besar/kecil.
Mungkin ada sejumlah spasi antara simbol GUID dan payload harfiah, tetapi tidak ada baris baru.
Guid'1afc7f5c-ffa0-4741-81cf-f12eAAb822bf'
GUID '1AFC7F5C-FFA0-4741-81CF-F12EAAB822BF'