カテゴリ:

変換関数

TO_BOOLEAN

入力テキストまたは数値式を BOOLEAN 値に変換します。

こちらもご参照ください。

TRY_TO_BOOLEAN

構文

TO_BOOLEAN( <string_or_numeric_expr> )
Copy

引数

string_or_numeric_expr

BOOLEAN 値に評価できる文字列式または数値式。

戻り値

BOOLEAN 値または NULL を返します。

  • string_or_numeric_expr が TRUE と評価された場合は、 TRUE を返します。

  • string_or_numeric_expr が FALSE と評価された場合は、 FALSE を返します。

  • 入力が NULL の場合は、エラーを報告せずに NULL を返します。

使用上の注意

  • 文字列式の場合、

    • 'true''t''yes''y''on''1' は TRUEを返します。

    • 'false''f''no''n''off''0' は FALSEを返します。

    • 他のすべての文字列はエラーを返します。

    文字列の評価は大文字と小文字を区別しません。

  • 数値式の場合:

    • 0 は、 FALSE を返します。

    • ゼロ以外のすべての数値は TRUE を返します。

    • FLOAT データ型から変換する場合、 NaN (非数値)や INF (無限大)のような数値以外の値はエラーを返します。

以下の例では、 TO_BOOLEAN 関数を使用しています。

テーブルを作成してデータを挿入します。

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 |
+-------+------+------+

文字列を BOOLEAN 値に変換します。

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

数値を BOOLEAN 値に変換します。

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