Literais

Os literais representam um valor constante de um tipo de dados integrado. Alguns tipos de dados podem ser expressos como literais, mas nem todos.

Literais de string

Os literais de string precisam estar entre aspas, simples ( ' ) ou duplas ( " ).

Literais entre aspas:

Literal Exemplo de uso Observações
String entre aspas
  • "abc"
  • "it's"
  • 'it\'s'
  • 'Title: "Boy"'
  • Strings entre aspas simples ( ' ) podem conter aspas duplas sem escape ( " ), bem como o inverso.
  • As barras invertidas ( \ ) iniciam sequências de escape. Veja a tabela Sequências de escape abaixo.
  • Strings entre aspas não podem conter novas linhas, mesmo se precedidas de barra invertida ( \ ).
String bruta
  • R"abc+"
  • r'f\(abc,(.\*),def\)'
  • Os literais entre aspas que têm o prefixo de literal de string bruta ( r ou R ) são interpretados como strings brutas/de expressões regulares.
  • Os caracteres de barra invertida ( \ ) não atuam como caracteres de escape. Se houver uma barra invertida seguida de outro caractere no literal de string, os dois caracteres serão preservados.
  • Não é possível encerrar uma string bruta com um número ímpar de barras invertidas.
  • As strings brutas são úteis para a construção de expressões regulares.

Sequências de escape para literais de string

A tabela a seguir lista todas as sequências de escape válidas para representar caracteres não alfanuméricos em literais de string. Qualquer sequência que não esteja nesta tabela resulta em erro.

Sequência de escape Descrição
\a Aviso sonoro
\b Backspace
\f Avanço de formulário
\n Nova linha
\r Retorno de carro
\t Tabulação
\v Tabulação vertical
\\ Barra invertida ( \ )
\? Ponto de interrogação ( ? )
\" Aspas duplas ( " )
\' Aspas simples ( ' )
\\` Acento grave ( \` )
\ooo Escape octal, com exatamente três dígitos (no intervalo de 0 a 7). É decodificado como um único caractere Unicode (em literais de strings) ou byte (em literais de bytes).
\xhh ou \Xhh Escape hexadecimal, com exatamente dois dígitos hexadecimais (0–9 ou A–F ou a–f). É decodificado como um único caractere Unicode (em literais de strings) ou byte (em literais de bytes). Exemplos:
  • '\x41' == 'A'
  • '\x41B' é 'AB'
  • '\x4' é um erro
\uhhhh Escape Unicode, com "u" minúsculo e exatamente quatro dígitos hexadecimais. Válido somente em literais de strings ou identificadores.

Observe que o intervalo D800-DFFF não é permitido, já que são valores Unicode alternativos.
\Uhhhhhhhh Escape Unicode, com 'U' maiúsculo e exatamente oito dígitos hexadecimais. Válido somente em literais de strings ou identificadores.

O intervalo D800-DFFF não é permitido porque esses são valores Unicode alternativos. Além disso, valores maiores que 10FFFF não são permitidos.

Literais de data

Para usar valores literais de data e hora em um campo calculado, basta preceder o valor com o marcador apropriado:

Literal Formato de data canônico Exemplo de uso
Data YYYY-[M]M-[D]D DATE '2021-4-1'
Data e hora [D]D-[M]M-AAAA [[H]H:[M]M:[S]S] DATETIME '2021-5-29 23:59:59'

Literais numéricos

Insira literais numéricos usando valores inteiros ou de ponto flutuante sem aspas. Exemplo:

Literal Exemplos Exemplo de uso
Número inteiro 1, -1, 0
  • 2 + 2
  • CASE WHEN Cost > 100 THEN...
Ponto flutuante 1.23, -1.2345
  • SQRT(3.14)
  • FLOOR(-42.123)

Literais booleanos

Use os valores literais true e false ao avaliar expressões booleanas. Exemplo:

IF( Boolean field = true, "yes","no")

IF( Boolean field = false, "no","yes")

IF( Boolean field, "yes","no")

IF(not Boolean field, "yes","no")