Boolean 函式
適用於: 畫布應用 桌面流 模型驅動應用 Power Pages Power Platform CLI
將文字字串、數字或非類型化值轉換為布林值。
描述
使用 Boolean 函數將其他類型轉換為布林值。 布林值為 True、False 或 空白。
在大多數情況下會自動進行類型強制型轉,不需要明確使用 Boolean 函數。 例如,If( "true", 1, 0 )
將傳回 1,因為文字字串 "true"
會自動轉換為布林值。 當需要明確轉換或使用非類型化值時,Boolean 函數會很有用。
語法
布林值 ( 字串 )
布林值 ( StringSingleColumnTable )
- string - 必需。 要轉換的字串。 必須是不區分大小寫的
"true"
或"false"
版本。 這些字串並未進行當地語系化。 Blank 和 Empty String 也被接受並轉換為 blank。 所有其他文字字串都會傳回錯誤。
布林值 ( 數位 )
布林值 ( NumberSingleColumnTable )
- Number - 必填。 要轉換的數字。
0
轉換為 false ,所有其他數位都轉換為 true。 接受空白 值並將其轉換為 空白值。
布林值 ( 未鍵入 )
- Untyped - 必需。 要轉換的非類型化值。 可接受的值取決於非類型化的提供者。 對於 JSON,可接受 JSON 布林值
true
、false
和null
,對應於 Power Fx 中的 True、False 和空白值。 接受字串或數字值,如前述 String 和 Number 多載所概述的。
範例
基本使用方式
公式 | 描述: | Result |
---|---|---|
布林值(“真”) | 將文字字串 "true" 轉換為布林值。 |
真 |
布林值(“false”) | 將文字字串 "false" 轉換為布林值。 |
假 |
布林值(“真”) | 將文字字串 "TRUE" 轉換為布林值。 |
真 |
布林值(“TrUe”) | 將文字字串 "TrUe" 轉換為布林值。 |
真 |
布林值(“真實”) | 嘗試將文字字串 "Truthful" 轉換成布林值,但由於它不是不區分大小寫的 true 和 false 變量,因此會傳回錯誤。 |
錯誤(參數無效) |
布林值 (空白()) | 將空白值轉換為布林值。 | 空白 |
布林值(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 ] |
布林值([“真”,“證偽”]) | 將文字字串的單一資料行資料表轉換成布林值的單一資料行資料表。 因為此資料表中的第二個記錄不是區分大小寫的 true 和 false 變量,因此會為此記錄傳回錯誤。 |
[ true, error (invalid argument) ] |
布林值([ 1,2,0 ]) | 將數字的單一資料行資料表轉換為布林值的單一資料行資料表。 | [ true, true, false ] |