类别：: 转换函数

TO_BOOLEAN¶

将输入文本或数值表达式转换为 BOOLEAN 值。

另请参阅：: TRY_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          |
+------+---------------+