Literais (Entity SQL)

Este tópico descreve o suporte de SQL de entidade para literais.

Nulo

O literal nulo é usado para representar o valor nulo para qualquer tipo. Um literal nulo é compatível com qualquer tipo.

Os nulos tipado podem ser criados por uma conversão sobre um literal nulo. Para obter mais informações, consulte CAST.

Para obter regras sobre onde literais nulos flutuantes livres podem ser usados, consulte Literais Nulos e Inferência de Tipo.

booleano

Literais boolianos são representados pelas palavras-chave true e false.

Número Inteiro

Literais inteiros podem ser do tipo Int32 ou Int64. Um Int32 literal é uma série de caracteres numéricos. Um Int64 literal é uma série de caracteres numéricos seguidos por um L maiúsculo.

Decimal

Um número de ponto fixo (decimal) é uma série de caracteres numéricos, um ponto (.) e outra série de caracteres numéricos seguidos por um "M" maiúsculo.

Float, Double

Um número de ponto flutuante de precisão dupla é uma série de caracteres numéricos, um ponto (.) e outra série de caracteres numéricos possivelmente seguidos por um expoente. Um número de ponto flutuante de precisão única (ou float) é uma sintaxe de número de ponto flutuante de precisão dupla seguida pelo f minúsculo.

fio

Uma cadeia de caracteres é uma série de caracteres entre aspas. Aspas podem ser aspas simples (') ou aspas duplas ("). Literais de cadeia de caracteres podem ser Unicode ou não Unicode. Para declarar um literal de cadeia de caracteres como Unicode, prefixe o literal com um "N" maiúsculo. O padrão são literais de cadeia de caracteres não Unicode. Não pode haver espaços entre o conteúdo literal N e a cadeia de caracteres e o N deve ser maiúsculo.

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

Data e Hora

Um literal datetime é independente da localidade e é composto por uma parte de data e uma parte de hora. As partes de data e hora são obrigatórias e não há valores padrão.

A parte de data deve ter o formato: YYYY--MMDD, onde YYYY é um valor de ano de quatro dígitos entre 0001 e 9999, MM é o mês entre 1 e 12 e DD é o valor de dia válido para o mês MMdeterminado.

A parte de hora deve ter o formato: HH:[:SS[.fffffff]], onde HH está o valor da hora entre 0 e 23, MM é o valor de minuto entre 0 e 59, SS é o segundo valor entre 0 e 59 e fffffff é o segundo valor fracionário entreMM 0 e 9999999. Todos os intervalos de valores são inclusivos. Segundos fracionários são opcionais. Segundos são opcionais, a menos que segundos fracionários sejam especificados; nesse caso, segundos são necessários. Quando segundos ou segundos fracionários não forem especificados, o valor padrão de zero será usado.

Pode haver qualquer número de espaços entre o símbolo DATETIME e o conteúdo literal, mas nenhuma linha nova.

DATETIME'2006-10-1 23:11'
DATETIME'2006-12-25 01:01:00.0000000' -- same as DATETIME'2006-12-25 01:01'

Hora

Um literal de tempo é independente da localidade e composto apenas por uma parte temporal. A parte de tempo é obrigatória e não há valor padrão. Ele deve ter o formato HH:MM[:SS[.fffffff]], onde HH é o valor de hora entre 0 e 23, MM é o valor de minuto entre 0 e 59, SS é o segundo valor entre 0 e 59, e fffffff é o segundo valor de fração entre 0 e 9999999. Todos os intervalos de valores são inclusivos. Segundos fracionários são opcionais. Segundos são opcionais, a menos que segundos fracionários sejam especificados; nesse caso, segundos são necessários. Quando segundos ou frações não forem especificados, o valor padrão de zero será usado.

Pode haver qualquer número de espaços entre o símbolo TIME e o conteúdo literal, mas nenhuma linha nova.

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

DateTimeOffset (representa uma data e hora com um desvio em relação ao horário UTC)

Um literal datetimeoffset é independente da localidade e é composto por uma parte de data, uma parte de hora e uma parte de deslocamento. Todas as partes de data, hora e deslocamento são obrigatórias e não há valores padrão. A parte de data deve ter o formato YYYY-MM-DD, onde YYYY é um valor de ano de quatro dígitos entre 0001 e 9999, MM é o mês entre 1 e 12, e DD é o valor de dia válido para o mês determinado. A parte de hora deve ter o formato HH:MM[:SS[.fffffff]], em que HH é o valor de hora entre 0 e 23, MM é o valor de minuto entre 0 e 59, SS é o segundo valor entre 0 e 59, e fffffff é o segundo valor fracionário entre 0 e 9999999. Todos os intervalos de valores são inclusivos. Segundos fracionários são opcionais. Segundos são opcionais, a menos que segundos fracionários sejam especificados; nesse caso, segundos são necessários. Quando segundos ou frações não forem especificados, o valor padrão de zero será usado. A parte de deslocamento deve ter o formato {+|-}HH:MM, em que HH e MM têm o mesmo significado que na parte de tempo. O intervalo do deslocamento, no entanto, deve estar entre -14:00 e + 14:00

Pode haver qualquer número de espaços entre o símbolo DATETIMEOFFSET e o conteúdo literal, mas não há novas linhas.

DATETIMEOFFSET'2006-10-1 23:11 +02:00'
DATETIMEOFFSET'2006-12-25 01:01:00.0000000 -08:30'

Binário

Um literal de cadeia de caracteres binária é uma sequência de dígitos hexadecimal delimitados por aspas simples após o binário da palavra-chave ou o símbolo X de atalho ou x. O símbolo X de atalho não diferencia maiúsculas de minúsculas. Um zero ou mais espaços são permitidos entre a palavra-chave binary e o valor da cadeia de caracteres binária.

Caracteres hexadecimal também não diferenciam maiúsculas de minúsculas. Se o literal for composto por um número ímpar de dígitos hexadecimal, o literal será alinhado ao próximo dígito hexadecimal, prefixando o literal com um dígito zero hexadecimal. Não há limite formal no tamanho da cadeia de caracteres binária.

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

GUID

Um GUID literal representa um identificador global exclusivo. É uma sequência formada pela palavra-chave GUID seguida por dígitos hexadecimal no formulário conhecido como formato do Registro : 8-4-4-4-12 entre aspas simples. Dígitos hexadecimal não diferenciam maiúsculas de minúsculas.

Pode haver qualquer número de espaços entre o símbolo GUID e o conteúdo literal, mas não há novas linhas.

Guid'1afc7f5c-ffa0-4741-81cf-f12eAAb822bf'
GUID  '1AFC7F5C-FFA0-4741-81CF-F12EAAB822BF'

Consulte também

• Visão geral da Entity SQL