Boolean 函式
適用於: 畫布應用程式 桌面流程 模型導向應用程式 Power Pages Power Platform CLI
將文字字串、數字或非類型化值轉換為布林值。
描述
使用 Boolean 函數將其他類型轉換為布林值。 布林值為 True、False 或 空白。
在大多數情況下會自動進行類型強制型轉,不需要明確使用 Boolean 函數。 例如,If( "true", 1, 0 )
將傳回 1,因為文字字串 "true"
會自動轉換為布林值。 當需要明確轉換或使用非類型化值時,Boolean 函數會很有用。
語法
Boolean( String )
布林值 (StringSingleColumnTable)
-
String - 必要。 要轉換的字串。 必須是不區分大小寫的
"true"
或"false"
版本。 這些字串並未進行當地語系化。 也可接受空白和空字串,並將其轉換成空白。 所有其他文字字串都會傳回錯誤。
Boolean( Number )
Boolean( NumberSingleColumnTable )
-
Number - 必要項目。 要轉換的數字。
0
會轉換為 False,而所有其他數字都會轉換為 True。 可接受空白值,並將其轉換為空白。
Boolean( Untyped )
-
Untyped - 必要項目。 要轉換的非類型化值。 可接受的值取決於非類型化的提供者。 對於 JSON,可接受 JSON 布林值
true
、false
和null
,對應於 Power Fx 中的 True、False 和空白值。 接受字串或數字值,如前述 String 和 Number 多載所概述的。
範例
基本使用方式
公式 | 描述: | Result |
---|---|---|
Boolean( "true" ) | 將文字字串 "true" 轉換為布林值。 |
True |
Boolean( "false" ) | 將文字字串 "false" 轉換為布林值。 |
False |
Boolean( "TRUE" ) | 將文字字串 "TRUE" 轉換為布林值。 |
True |
Boolean( "TrUe" ) | 將文字字串 "TrUe" 轉換為布林值。 |
True |
Boolean( "Truthful" ) | 嘗試將文字字串 "Truthful" 轉換成布林值,但由於它不是不區分大小寫的 true 和 false 變量,因此會傳回錯誤。 |
error (invalid argument) |
Boolean( Blank() ) | 將空白值轉換為布林值。 | 空白 |
Boolean( 0 ) | 將數字 0 轉換為布林值。 |
False |
Boolean( 1 ) | 將數字 1 轉換為布林值。 |
True |
Boolean( -1234 ) | 將數字 -1234 轉換為布林值。 |
True |
非類型化的使用方式
公式 | 描述 | Result |
---|---|---|
Boolean( ParseJSON( "{ ""bool"": true }" ).bool ) | 將非類型化值 true (JSON 布林值) 轉換為布林值。 |
True |
Boolean( ParseJSON( "{ ""bool"": null }" ).bool ) | 將非類型化值 null (JSON Null) 轉換為布林值。 |
空白 |
Boolean( ParseJSON( "{ ""bool"": "true" }" ).bool ) | 嘗試將非類型化值 "true" (JSON 字串) 轉換為布林值,但是因為它不是 JSON 中的有效布林值,所以會傳回錯誤。 |
error (invalid argument) |
Boolean( ParseJSON( "[ true, false, null ]" ).bool ) | 嘗試將布林值陣列轉換成單一資料行資料表。 單一資料行資料表不支援非類型化值,而應使用 ForAll( Table(ParseJSON( "[true, false, null]" )), Boolean( ThisRecord.Value ) ) 或 ForAll( ParseJSON( "[true, false, null]" ), Boolean( ThisRecord ) ) 公式。 |
error (invalid argument) |
單一資料行資料表
公式 | 描述 | Result |
---|---|---|
Boolean( [ "true", "false", Blank() ] ) | 將文字字串的單一資料行資料表轉換成布林值的單一資料行資料表。 | [ true, false, blank ] |
Boolean( [ "true", "falsified" ] ) | 將文字字串的單一資料行資料表轉換成布林值的單一資料行資料表。 因為此資料表中的第二個記錄不是區分大小寫的 true 和 false 變量,因此會為此記錄傳回錯誤。 |
[ true, error (invalid argument) ] |
Boolean( [ 1, 2, 0 ] ) | 將數字的單一資料行資料表轉換為布林值的單一資料行資料表。 | [ true, true, false ] |