Literal (Entity SQL)

Topik ini menjelaskan dukungan SQL Entitas untuk literal.

Nol

Literal null digunakan untuk mewakili nilai null untuk jenis apa pun. Literal null kompatibel dengan jenis apa pun.

Null yang diketik dapat dibuat oleh cast melalui harfiah null. Untuk informasi selengkapnya, lihat CAST.

Untuk aturan tentang di mana literal null mengambang gratis dapat digunakan, lihat Literal Null dan Inferensi Jenis.

Boolean

Literal Boolean diwakili oleh kata kunci true dan false.

Integer

Literal bilangan bulat bisa berjenis Int32 atau Int64. Harfiah Int32 adalah serangkaian karakter numerik. Harfiah Int64 adalah serangkaian karakter numerik diikuti oleh huruf besar L.

Desimal

Angka titik tetap (desimal) adalah serangkaian karakter numerik, titik (.) dan serangkaian karakter numerik lainnya diikuti oleh huruf besar "M".

Float, Double

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 sintaks angka titik mengambang presisi ganda diikuti oleh huruf kecil f.

string

String adalah serangkaian karakter yang diapit dalam tanda kutip. Tanda kutip dapat berupa tanda kutip tunggal (') atau tanda kutip ganda ("). Literal string karakter dapat berupa Unicode atau non-Unicode. Untuk mendeklarasikan string karakter harfiah sebagai Unicode, awali harfiah dengan huruf besar "N". Defaultnya adalah string karakter non-Unicode literal. Tidak boleh ada spasi antara N dan payload literal string, dan N harus huruf besar.

'hello' -- non-Unicode character string literal
N'hello' -- Unicode character string literal
"x"
N"This is a string!"
'so is THIS'

Tanggal dan Waktu

Harfiah tanggalwaktu tidak bergantung pada lokal dan terdiri dari bagian tanggal dan bagian waktu. Bagian tanggal dan waktu bersifat wajib dan tidak ada nilai default.

Bagian tanggal harus memiliki format: YYYY-DD-MM, di mana YYYY adalah nilai tahun empat digit antara 0001 dan 9999, MM adalah bulan antara 1 dan 12 dan DD merupakan nilai hari yang berlaku untuk bulan MMtertentu .

Bagian waktu harus memiliki format: HH:[:SS[.fffffff]], dengan HH 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 kedua pecahan antaraMM 0 dan 9999999. Semua rentang nilai bersifat inklusif. Detik pecahan bersifat opsional. Detik bersifat opsional kecuali detik pecahan ditentukan; dalam hal ini, detik diperlukan. Ketika detik atau detik pecahan tidak ditentukan, nilai default nol akan digunakan sebagai gantinya.

Mungkin ada sejumlah spasi antara simbol DATETIME 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

Literal waktu independen dari lokal dan terdiri dari bagian waktu saja. Bagian waktu wajib dan tidak ada nilai default. Ini 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 fffffff adalah nilai pecahan kedua antara 0 dan 9999999. Semua rentang nilai bersifat inklusif. Detik pecahan bersifat opsional. Detik bersifat opsional kecuali detik pecahan 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 TIME dan payload harfiah, tetapi tidak ada baris baru.

TIME'23:11'
TIME'01:01:00.1234567'

Pengaturan Waktu & Tanggal

Literal datetimeoffset independen dari lokal dan terdiri dari bagian tanggal, bagian waktu, dan bagian offset. Semua bagian tanggal, waktu, dan offset 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 fffffff adalah nilai kedua pecahan antara 0 dan 9999999. Semua rentang nilai bersifat inklusif. Detik pecahan bersifat opsional. Detik bersifat opsional kecuali detik pecahan 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 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'

Nota

Nilai literal SQL Entitas yang valid dapat berada di luar rentang yang didukung untuk CLR atau sumber data. Ini dapat mengakibatkan pengecualian

Biner

String biner literal adalah urutan digit heksadesimal yang dibatasi oleh tanda kutip tunggal mengikuti biner kata kunci atau simbol X pintasan atau x. Simbol X pintasan tidak peka huruf besar/kecil. Spasi nol atau lebih diperbolehkan antara kata kunci binary dan nilai string biner.

Karakter heksadesimal juga tidak peka huruf besar/kecil. Jika literal terdiri dari sejumlah digit heksadesimal ganjil, literal akan diselaraskan ke digit heksadesimal berikutnya dengan awalan literal dengan digit nol heksadesimal. Tidak ada batas formal pada ukuran string biner.

Binary'00ffaabb'
X'ABCabc'
BINARY    '0f0f0f0F0F0F0F0F0F0F'
X'' -- empty binary string

Panduan

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 dalam 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'

Lihat juga

• Gambaran Umum SQL Entitas