TO_BOOLEAN¶

構文¶

TO_BOOLEAN( <string_or_numeric_expr> )

引数¶

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;

+-------+------+------+
| B     |    N | S    |
|-------+------+------|
| True  |    1 | yes  |
| False |    0 | no   |
| NULL  | NULL | NULL |
+-------+------+------+

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

SELECT s, TO_BOOLEAN(s) FROM test_boolean;

+------+---------------+
| S    | TO_BOOLEAN(S) |
|------+---------------|
| yes  | True          |
| no   | False         |
| NULL | NULL          |
+------+---------------+

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

SELECT n, TO_BOOLEAN(n) FROM test_boolean;

+------+---------------+
|    N | TO_BOOLEAN(N) |
|------+---------------|
|    1 | True          |
|    0 | False         |
| NULL | NULL          |
+------+---------------+