分享方式:


Boolean 函式

適用於: 畫布應用 桌面流 模型驅動應用 Power Pages Power Platform CLI

將文字字串、數字或非類型化值轉換為布林值。

名描述

使用 Boolean 函數將其他類型轉換為布林值。 布林值為 TrueFalse空白

在大多數情況下會自動進行類型強制型轉,不需要明確使用 Boolean 函數。 例如,If( "true", 1, 0 ) 將傳回 1,因為文字字串 "true" 會自動轉換為布林值。 當需要明確轉換或使用非類型化值時,Boolean 函數會很有用。

語法

布林值 ( 字串 )
布林值 ( StringSingleColumnTable )

  • string - 必需。 要轉換的字串。 必須是不區分大小寫的 "true""false" 版本。 這些字串並未進行當地語系化。 Blank 和 Empty String 也被接受並轉換為 blank。 所有其他文字字串都會傳回錯誤。

布林值 ( 數位 )
布林值 ( NumberSingleColumnTable )

  • Number - 必填。 要轉換的數字。 0 轉換為 false ,所有其他數位都轉換為 true接受空白 值並將其轉換為 空白值。

布林值 ( 未鍵入 )

  • Untyped - 必需。 要轉換的非類型化值。 可接受的值取決於非類型化的提供者。 對於 JSON,可接受 JSON 布林值 truefalsenull,對應於 Power Fx 中的 TrueFalse空白值。 接受字串或數字值,如前述 StringNumber 多載所概述的。

範例

基本使用方式

公式 名描述 Result
布林值(“真”) 將文字字串 "true" 轉換為布林值。
布林值(“false”) 將文字字串 "false" 轉換為布林值。
布林值(“真”) 將文字字串 "TRUE" 轉換為布林值。
布林值(“TrUe”) 將文字字串 "TrUe" 轉換為布林值。
布林值(“真實”) 嘗試將文字字串 "Truthful" 轉換成布林值,但由於它不是不區分大小寫的 truefalse 變量,因此會傳回錯誤。 錯誤(參數無效)
布林值 (空白()) 空白值轉換為布林值。 空白
布林值(0) 將數字 0 轉換為布林值。
布林值(1) 將數字 1 轉換為布林值。
布林值(-1234) 將數字 -1234 轉換為布林值。

非類型化的使用方式

公式 名描述 Result
布林值 (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 ) ) 公式。 錯誤(參數無效)

單一資料行資料表

公式 名描述 Result
布林值 ([“true”,“false”,Blank()]) 將文字字串的單一資料行資料表轉換成布林值的單一資料行資料表。 [ true, false, blank ]
布林值([“真”,“證偽”]) 將文字字串的單一資料行資料表轉換成布林值的單一資料行資料表。 因為此資料表中的第二個記錄不是區分大小寫的 truefalse 變量,因此會為此記錄傳回錯誤。 [ true, error (invalid argument) ]
布林值([ 1,2,0 ]) 將數字的單一資料行資料表轉換為布林值的單一資料行資料表。 [ true, true, false ]