Boolean 函数
适用于：
画布应用 桌面流 模型驱动应用 Power Pages Power Platform CLI
将文本字符串、数字或非类型化值转换为布尔值。
说明
使用 Boolean 函数将其他类型转换为布尔值。 布尔值为 true、false 或 blank。
在大多数情况下，类型强制转换会自动发生，不需要显式使用 Boolean 函数。 例如，If( "true", 1, 0 ) 将返回 1，因为文本字符串 "true" 会自动转换为布尔值。 Boolean 函数在需要显式转换或使用非类型化值时很有用。
语法
布尔（ 字符串 ）
布尔（ 字符串单列表 ）
- string - 必需。 要转换的字符串。 必须是
"true"或"false"的不区分大小写版本。 这些字符串不本地化。 Blank 和 Empty String 也被接受并转换为 blank。 所有其他文本字符串均返回错误。
布尔（ 数字 ）
布尔（ 数字单列表 ）
- Number - 必填。 要转换的数字。
0转换为 false ，所有其他数字都转换为 true。 接受空白 值并将其转换为 空白值。
布尔（ 未键入 ）
- Untyped - 必需。 要转换的非类型化值。 可接受值取决于非类型化提供程序。 对于 JSON，接受 JSON 布尔值
true、false和null，对应于 Power Fx 中的 true、false 和 blank 值。 如针对前述的字符串和数字重载所概述的那样，接受字符串或数字值。
示例
基本用法
| 公式 | 说明 | 结果 |
|---|---|---|
| 布尔（“真”） | 将文本字符串 "true" 转换为布尔值。 |
真 |
| 布尔值（“false”） | 将文本字符串 "false" 转换为布尔值。 |
假 |
| 布尔值（“TRUE”） | 将文本字符串 "TRUE" 转换为布尔值。 |
真 |
| 布尔（“TrUe”） | 将文本字符串 "TrUe" 转换为布尔值。 |
真 |
| 布尔（“真实”） | 尝试将文本字符串 "Truthful" 转换为布尔值，但由于它不是 true 和 false 的不区分大小写的变体，因此返回错误。 |
错误（参数无效） |
| 布尔（空白（）） | 将空白值转换为布尔值。 | 空白 |
| 布尔（0） | 将数字 0 转换为布尔值。 |
假 |
| 布尔（1） | 将数字 1 转换为布尔值。 |
真 |
| 布尔（-1234） | 将数字 -1234 转换为布尔值。 |
真 |
非类型化使用
| 公式 | 说明 | 结果 |
|---|---|---|
| 布尔（ParseJSON（“{ ”“bool”“：true }”）.bool） | 将非类型化值 true（一个 JSON 布尔值）转换为布尔值。 |
真 |
| 布尔值（ParseJSON（“{ ”“bool”“”：null }“）.bool） | 将非类型化值 null（一个 JSON null 值）转换为布尔值。 |
空白 |
| 布尔值（ParseJSON（“{ ”“bool”“：”true“ }”）.bool） | 尝试将非类型化值 "true"（一个 JSON 字符串）转换为布尔值，但由于它不是 JSON 中的有效布尔值，因此返回错误。 |
错误（参数无效） |
| 布尔值（ParseJSON（“[ true，false，null ]”）.bool） | 尝试将布尔值数组转换为单列表。 非类型化值不支持单列表，应使用公式 ForAll( Table(ParseJSON( "[true, false, null]" )), Boolean( ThisRecord.Value ) ) 或 ForAll( ParseJSON( "[true, false, null]" ), Boolean( ThisRecord ) )。 |
错误（参数无效） |
单列表
| 公式 | 说明 | 结果 |
|---|---|---|
| 布尔（[“真”，“假”，空白（）]） | 将文本字符串的单列表转换为布尔值的单列表。 | [ true, false, blank ] |
| 布尔（[“真”，“伪造”]） | 将文本字符串的单列表转换为布尔值的单列表。 由于此表中的第二个记录不是 true 和 false 的不区分大小写的变体，此记录返回错误。 |
[ true, error (invalid argument) ] |
| 布尔（[ 1，2，0 ]） | 将数字的单列表转换为布尔值的单列表。 | [ true, true, false ] |