通过

Boolean 函数

适用于： 画布应用 Copilot Studio Desktop 流 模型驱动应用 Power Platform CLI Dataverse 函数 Power Pages

将文本、数字或动态值转换为 Boolean 值。

说明

使用 Boolean 函数将其他类型的 Boolean 转换为值。 Boolean值为 true、false 或空白。

在大多数情况下，类型强制会自动发生，无需显式使用 Boolean 函数。 例如， If( "true", 1, 0 ) 返回 1，因为文本字符串 "true" 会自动转换为一个 Boolean。 当需要显式转换或使用动态值时，该 Boolean 函数非常有用。

语法

Boolean（ 文本 ）
Boolean（ TextSingleColumnTable ）

  • 文本 - 必需。 要转换的字符串。 必须是 "true" 或 "false" 的不区分大小写版本。 这些文本字符串未本地化。 空白 文本和空文本也接受并转换为 空白。 所有其他文本字符串均返回错误。

Boolean（ 数字 ）
Boolean（ NumberSingleColumnTable ）

  • Number - 必填。 要转换的数字。 0 转换为 false ，所有其他数字都转换为 true。 接受空白 值并将其转换为 空白值。

Boolean（ DynamicValue ）

  • DynamicValue - 必需。 要转换的动态值。 可接受的值取决于动态提供程序。 对于 JSON，接受 JSON 布尔值 true、false 和 null，对应于 Power Fx 中的 true、false 和 blank 值。 如针对前述的字符串和数字重载所概述的那样，接受字符串或数字值。

示例

基本用法

公式 说明 结果
Boolean（“true” ） 将文本字符串 "true" 转换为布尔值。 真
Boolean（“false” ） 将文本字符串 "false" 转换为布尔值。 假
Boolean（“TRUE” ） 将文本字符串 "TRUE" 转换为布尔值。 真
Boolean（“TrUe”） 将文本字符串 "TrUe" 转换为布尔值。 真
Boolean（“真话” ） 尝试将文本字符串 "Truthful" 转换为布尔值，但由于它不是 true 和 false 的不区分大小写的变体，因此返回错误。 错误（参数无效）
Boolean（空白（） 将 空白 值转换为布尔值。 空白
Boolean( 0 ) 将数字 0 转换为布尔值。 假
Boolean( 1 ) 将数字 1 转换为布尔值。 真
Boolean（-1234） 将数字 -1234 转换为布尔值。 真

动态用法

公式 说明 结果
Boolean（ParseJSON（“{ ”“bool”：true }“ ）。bool ） 将动态值 true （JSON Boolean）转换为布尔值。 真
Boolean（ParseJSON（“{ ”“bool”：null }“ ）bool ） 将动态值 null （JSON null）转换为布尔值。 空白
Boolean（ParseJSON（“{ ”“bool”“： ”true“ }” ）。bool ） 尝试将动态值 "true" （JSON 字符串）转换为布尔值，但由于它不是 JSON 中的有效布尔值，因此将返回错误。 错误（参数无效）
Boolean（ParseJSON（“[ true， false， null ]” ）。bool ） 尝试将布尔值数组转换为单列表。 动态值不支持单列表，而是使用公式 ForAll( Table(ParseJSON( "[true, false, null]" )), Boolean( ThisRecord.Value ) ) 或 ForAll( ParseJSON( "[true, false, null]" ), Boolean( ThisRecord ) ) 应使用。 错误（参数无效）

单列表

公式 说明 结果
Boolean（ [ “true”， “false”， Blank（） ] 将文本字符串的单列表转换为布尔值的单列表。 [ true、 false、 blank ]
Boolean（ [ “true”， “falsified” ] ] 将文本字符串的单列表转换为布尔值的单列表。 由于此表中的第二个记录不是 true 和 false 的不区分大小写的变体，此记录返回错误。 [ true， error （无效参数） ]
Boolean( [ 1, 2, 0 ] ) 将单列数字表转换为布尔值的单个列表。 [ true、 true、 false ]