適用対象:
キャンバス アプリ Copilot Studio デスクトップ フロー モデル駆動型アプリ Power Platform CLI Dataverse 関数 Power Pages
テキスト、数値、または動的な値を Boolean 値に変換します。
説明設定
Boolean関数を使用して、他の型をBoolean値に変換します。 Boolean値は true、false、または空白です。
ほとんどの場合、型強制型は自動的に行われ、 Boolean 関数を明示的に使用する必要はありません。 たとえば、テキスト文字列"true"が自動的にBooleanに変換されるため、If( "true", 1, 0 )は 1 を返します。
Boolean関数は、明示的な変換が必要な場合や動的な値を使用する場合に便利です。
構文
Boolean( テキスト )
Boolean( TextSingleColumnTable )
-
テキスト - 必須。 変換する文字列。
"true"または"false"の大文字と小文字を区別しないバージョンである必要があります。 これらのテキスト文字列はローカライズされません。 空白 と空のテキストも受け入れられ、 空白に変換されます。 他のすべてのテキスト文字列はエラーを返します。
Boolean( 数値 )
Boolean( NumberSingleColumnTable )
-
番号 - 必須。 変換する数字。
0は false に変換され、他のすべての数値は trueに変換されます。 空白 値が受け入れられ、 空白に変換されます。
Boolean( DynamicValue )
-
DynamicValue - 必須。 変換する動的な値。 許容される値は、動的プロバイダーによって異なります。
JSON の場合、JSON ブール値は
true、false、nullが受け入れられ、Power Fx での true、false、と 空欄 の値が対応します。 文字列または数値は、先程説明した 文字列 および 数字 のオーバーロードの概説として承認されています。
使用例
基本的な使用
| 式 | 説明設定 | Result |
|---|---|---|
| Boolean( "true" ) | テキスト文字列 "true" をブール値に変換します。 |
真実 |
| Boolean( "false" ) | テキスト文字列 "false" をブール値に変換します。 |
間違い |
| Boolean( "TRUE" ) | テキスト文字列 "TRUE" をブール値に変換します。 |
真実 |
| Boolean( "TrUe" ) | テキスト文字列 "TrUe" をブール値に変換します。 |
真実 |
| Boolean( "Truthful" ) | テキスト文字列 "Truthful" のブール値への変換を試みますが、true と false の大文字と小文字を区別しないバリエーションではないため、エラーが返されます。 |
エラー (無効な引数) |
| Boolean( Blank() ) | 空白の値をブール値に変換します。 | 空白 |
| Boolean( 0 ) |
0数値をブール値に変換します。 |
間違い |
| Boolean( 1 ) |
1数値をブール値に変換します。 |
真実 |
| Boolean( -1234 ) |
-1234数値をブール値に変換します。 |
真実 |
動的な使用法
| 式 | 説明設定 | Result |
|---|---|---|
| Boolean( ParseJSON( "{ ""bool"": true }" ).bool ) | 動的な値 true (JSON Boolean) をブール値に変換します。 |
真実 |
| Boolean( ParseJSON( "{ ""bool"": null }" ).bool ) | 動的値 null (JSON null) をブール値に変換します。 |
空白 |
| 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 番目のレコードは、true と false の大文字と小文字を区別しないバリエーションではないため、このレコードに対してエラーが返されます。 |
[ true, error (無効な引数) ] |
| Boolean( [ 1, 2, 0 ] ) | 数値の単一列テーブルをブール値の単一列テーブルに変換します。 | [ true, true, false ] |