Categorias:

Funções de conversão

TO_BOOLEAN

Converte o texto de entrada ou a expressão numérica em um valor BOOLEAN.

Consulte também:

TRY_TO_BOOLEAN

Sintaxe

TO_BOOLEAN( <string_or_numeric_expr> )
Copy

Argumentos

string_or_numeric_expr

Uma expressão de cadeia de caracteres ou expressão numérica que pode ser avaliada em um valor BOOLEAN.

Retornos

Retorna um valor BOOLEAN ou NULL.

  • Retorna TRUE se string_or_numeric_expr for avaliado como TRUE.

  • Retorna FALSE se string_or_numeric_expr for avaliado como FALSE.

  • Se a entrada for NULL, retorna NULL sem relatar um erro.

Notas de uso

  • Para uma expressão de cadeia de caracteres:

    • 'true', 't', 'yes', 'y', 'on', '1' retornam TRUE.

    • 'false', 'f', 'no', 'n', 'off', '0' retornam FALSE.

    • Todas as outras cadeias de caracteres retornam um erro.

    As avaliações das cadeias de caracteres não diferenciam maiúsculas de minúsculas.

  • Para uma expressão numérica:

    • 0 retorna FALSE.

    • Todos os valores numéricos diferentes de zero retornam TRUE.

    • Ao converter do tipo de dados FLOAT, os valores não numéricos, como NaN (não é um número) e INF (infinito), retornam um erro.

Exemplos

Os exemplos a seguir usam a função TO_BOOLEAN.

Criar uma tabela e inserir dados:

CREATE OR REPLACE TABLE test_boolean(
  b BOOLEAN,
  n NUMBER,
  s STRING);

INSERT INTO test_boolean VALUES
  (true, 1, 'yes'),
  (false, 0, 'no'),
  (null, null, null);

SELECT * FROM test_boolean;
Copy
+-------+------+------+
| B     |    N | S    |
|-------+------+------|
| True  |    1 | yes  |
| False |    0 | no   |
| NULL  | NULL | NULL |
+-------+------+------+

Converta uma cadeia de caracteres de texto em um valor BOOLEAN:

SELECT s, TO_BOOLEAN(s) FROM test_boolean;
Copy
+------+---------------+
| S    | TO_BOOLEAN(S) |
|------+---------------|
| yes  | True          |
| no   | False         |
| NULL | NULL          |
+------+---------------+

Converta um número em um valor BOOLEAN:

SELECT n, TO_BOOLEAN(n) FROM test_boolean;
Copy
+------+---------------+
|    N | TO_BOOLEAN(N) |
|------+---------------|
|    1 | True          |
|    0 | False         |
| NULL | NULL          |
+------+---------------+