Boolean 関数

適用先 : キャンバス アプリ デスクトップ フロー モデル駆動型アプリ Power Platform CLI

ブール値 – テキスト文字列、数値、または型指定されていない値をブール値に変換します。

説明設定

ブール値 関数を使用して、その他の型をブール値に変換します。 ブール値は、truefalse、または 空白 です。

ほとんどの場合、型強制は自動的に行われ、ブール値 関数を明示的に使用する必要はありません。 例えば、If( "true", 1, 0 ) は、テキスト文字列として 1 を返し、"true" はブール値に自動的に変換されます。 ブール値 関数は、明示的な変換が必要な場合、または型指定されていない値を使用する場合に役立ちます。

構文

ブール値( 文字列 )
ブール値( StringSingleColumnTable )

  • String - 必須。 変換する文字列。 "true" または "false" の大文字と小文字を区別しないバージョンである必要があります。 これらの文字列はローカライズされていません。 空欄 と空の文字列も受け入れられ、空欄 に変換されます。 他のすべてのテキスト文字列はエラーを返します。

ブール値( 番号 )
ブール値( NumberSingleColumnTable )

  • Number - 必須。 変換する数字。 0false に変換され、他のすべての数値は true に変換されます。 空欄 値が受け入れられ、空欄 に変換されます。

ブール値( 型指定されていない )

  • Untyped - 必須。 変換する型指定されていない値。 許容値は、型指定されていないプロバイダーによって異なります。 JSON の場合、JSON ブール値は truefalsenull が受け入れられ、Power Fx での truefalse、と 空欄 の値が対応します。 文字列または数値は、先程説明した 文字列 および 数字 のオーバーロードの概説として承認されています。

使用例

基本的な使用

Description Result
Boolean( "true" ) テキスト文字列 "true" をブール値に変換します。 true
Boolean( "false" ) テキスト文字列 "false" をブール値に変換します。
Boolean( "TRUE" ) テキスト文字列 "TRUE" をブール値に変換します。 true
Boolean( "TrUe" ) テキスト文字列 "TrUe" をブール値に変換します。 true
Boolean( "Truthful" ) テキスト文字列 "Truthful" のブール値への変換を試みますが、truefalse の大文字と小文字を区別しないバリエーションではないため、エラーが返されます。 エラー (無効な引数)
Boolean( Blank() ) 空欄 値をブール値に変換します。 blank
Boolean( 0 ) 数字 0 をブール値に変換します。
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) をブール値に変換します。 blank
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 ) ) を使用すべきです。 エラー (無効な引数)

単一列テーブル

説明設定 Result
Boolean( [ "true", "false", Blank() ] ) テキスト文字列の単一列テーブルをブール値の単一列テーブルに変換します。 [ true, false, blank ]
Boolean( [ "true", "falsified" ] ) テキスト文字列の単一列テーブルをブール値の単一列テーブルに変換します。 このテーブルの 2 番目のレコードは、truefalse の大文字と小文字を区別しないバリエーションではないため、このレコードに対してエラーが返されます。 [ true, error (無効な引数) ]
Boolean( [ 1, 2, 0 ] ) 数字の単一列テーブルをブール値の単一列テーブルに変換します。 [ true, true, false ]