Boolean 函式

適用於： 畫布應用程式桌面流程模型導向應用程式 Power Platform CLI

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

描述

使用 Boolean 函數將其他類型轉換為布林值。布林值為 True、False 或空白。

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

Boolean( String )
布林值 (StringSingleColumnTable)

String - 必要。要轉換的字串。必須是不區分大小寫的 "true" 或 "false" 版本。這些字串並未進行當地語系化。也可接受空白和空字串，並將其轉換成空白。所有其他文字字串都會傳回錯誤。

Boolean( Number )
Boolean( NumberSingleColumnTable )

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 ]