Funktion „Boolean“

Gilt für: Canvas-Apps Desktop-Flows Modellgesteuerte Apps Power Pages Power Platform CLI

Konvertiert eine Textzeichenfolge, eine Zahl oder einen nicht typisierten Wert in einen booleschen Wert.

Beschreibung

Verwenden Sie die Boolean-Funktion zum Konvertieren anderer Typen in einen booleschen Wert. Ein boolescher Wert ist true, false oder blank.

In den meisten Fällen erfolgt die Typzwangsänderung automatisch und die Boolean-Funktion muss nicht explizit verwendet werden. Zum Beispiel,If( "true", 1, 0 ) gibt 1 als Textzeichenfolge zurück, "true" wird automatisch in einen booleschen Wert umgewandelt. Die Funktion Boolean ist nützlich, wenn eine explizite Konvertierung gewünscht wird oder wenn ein nicht typisierter Wert verwendet wird.

Syntax

boolesch( String )
boolesch( ZeichenfolgeEinzelspaltentabelle )

• String – Erforderlich. Die zu konvertierende(n) Zeichenfolge(n). Muss eine Version von "true" oder "false" sein, bei der die Groß-/Kleinschreibung nicht beachtet wird. Diese Zeichenfolgen sind nicht lokalisiert. Leerzeichen und leere Zeichenfolgen werden ebenfalls akzeptiert und in ein Leerzeichen umgewandelt. Alle anderen Textzeichenfolgen geben einen Fehler zurück.

boolesch( Nummer )
boolesch( AnzahlEinzelspaltenTabelle )

• Nummer - Erforderlich. Die zu konvertierende(n) Zahl(en). 0 wird in falsch umgewandelt und alle anderen Zahlen werden in wahr umgewandelt. leere Werte werden akzeptiert und in leere Werte umgewandelt.

boolesch( Untypisiert )

• Nicht typisiert – Erforderlich. Der nicht typisierte Wert, der konvertiert werden soll. Zulässige Werte hängen vom nicht typisierten Anbieter ab. Für JSON werden boolesche JSON-Werte true, false und null akzeptiert, entsprechend zu den Werten true, false und blank in Power Fx. Zeichenfolgen- oder Zahlenwerte werden wie beschrieben akzeptiert für die vorher beschriebenen Zeichenfolge- und Zahl-Überladungen.

Beispiele

Grundlegende Nutzung

Formel	Beschreibung	Result
boolesch( "wahr" )	Konvertiert den Textwert "true" in einen booleschen Wert.	WAHR
boolesch( "falsch" )	Konvertiert den Textwert "false" in einen booleschen Wert.	FALSCH
boolesch( "WAHR" )	Konvertiert den Textwert "TRUE" in einen booleschen Wert.	WAHR
boolesch( "Wahr" )	Konvertiert den Textwert "TrUe" in einen booleschen Wert.	WAHR
boolesch( "Wahrhaftig" )	Versucht, die Textzeichenfolge "Truthful" in einen booleschen Wert zu konvertieren, da es sich aber nicht um eine Variation von true und false handelt, bei der die Groß-/Kleinschreibung nicht beachtet wird, wird ein Fehler zurückgegeben.	Fehler (ungültiges Argument)
boolesch( Leer() )	Konvertiert den Wert blank in einen booleschen Wert.	leer
boolesch( 0 )	Konvertiert die Zahl 0 in einen booleschen Wert.	FALSCH
boolesch( 1 )	Konvertiert die Zahl 1 in einen booleschen Wert.	WAHR
boolesch( -1234 )	Konvertiert die Zahl -1234 in einen booleschen Wert.	WAHR

Nicht typisierte Verwendung

Formel	Beschreibung	Result
boolesch(ParseJSON( "{ ""bool"": true }" ).bool )	Konvertiert den nicht typisierten Wert true (ein boolescher JSON-Wert) in einen booleschen Wert.	WAHR
boolesch(ParseJSON( "{ ""bool"": null }" ).bool )	Konvertiert den nicht typisierten Wert null (ein JSON-Nullwert) in einen booleschen Wert.	leer
boolesch(ParseJSON( "{ ""bool"": "true" }" ).bool )	Versucht, den nicht typisierten Wert "true" (eine JSON-Zeichenfolge) in einen booleschen Wert zu konvertieren, aber da es sich nicht um einen gültigen booleschen Wert in JSON handelt, wird ein Fehler zurückgegeben.	Fehler (ungültiges Argument)
boolesch(ParseJSON( "[true, false, null ]" ).bool )	Versucht, ein Array von booleschen Werten in eine Tabelle mit einer einzelnen Spalte zu konvertieren. Einspaltige Tabellen werden nicht mit nicht typisierten Werten unterstützt, und stattdessen sollte die Formel ForAll( Table(ParseJSON( "[true, false, null]" )), Boolean( ThisRecord.Value ) ) oder ForAll( ParseJSON( "[true, false, null]" ), Boolean( ThisRecord ) ) benutzt werden.	Fehler (ungültiges Argument)

Einspaltige Tabellen

Formel	Beschreibung	Result
boolesch( [ "wahr", "falsch", Blank() ] )	Konvertiert die einspaltige Tabelle mit Textzeichenfolgen in eine einspaltige Tabelle mit booleschen Werten.	[ wahr, falsch, leer ]
boolesch( [ "wahr", "gefälscht" ] )	Konvertiert die einspaltige Tabelle mit Textzeichenfolgen in eine einspaltige Tabelle mit booleschen Werten. Da der zweite Datensatz in dieser Tabelle keine Variante von true und false ist, bei der die Groß-/Kleinschreibung nicht berücksichtigt wird, wird für diesen Datensatz ein Fehler zurückgegeben.	[ wahr, Fehler (ungültiges Argument) ]
boolesch( [ 1, 2, 0 ] )	Konvertiert die einspaltige Tabelle mit Zahlen in eine einspaltige Tabelle mit booleschen Werten.	[ wahr, wahr, falsch ]