Partajați prin

Funcția Boolean

  • Articol

Se aplică pentru: planșă de lucru aplicații Fluxuri desktop Aplicații bazate pe model Power Pages Power Platform CLI

Convertește un șir de text, un număr sau o valoare netipificată într-o valoare booleană.

Descriere

Utilizați funcția Boolean pentru a converti alte tipuri într-o valoare booleană. O valoare Boolean value etse true, false sau blank.

În cele mai multe cazuri, constrângerea de tip are loc automat, iar funcția Boolean nu trebuie utilizată în mod explicit. De exemplu, If( "true", 1, 0 ) va returna 1 deoarece șirul de text "true" este convertit automat într-un boolean. Funcția Boolean este utilă atunci când se dorește o conversie explicită sau când se utilizează o valoare netipificată.

Sintaxă

Boolean( Șir )
Boolean( StringSingleColumnTable )

  • Șir - Obligatoriu. Șirurile de convertit. Trebuie să fie o versiune care nu ține seama de majuscule și minuscule de "true" sau "false". Aceste șiruri nu sunt localizate. blank și șirul gol este, de asemenea, acceptat și convertit într-un blank. Toate celelalte șiruri de text returnează o eroare.

Boolean( Număr )
Boolean( NumberSingleColumnTable )

  • Number - Obligatoriu. Numerele de convertit. 0 este convertit în fals și toate celelalte numere sunt convertite în adevărat. blank sunt acceptate și convertite într-un blank.

Boolean( Untyped )

  • Untyped - Obligatoriu. Valoarea netipificată de convertit. Valorile acceptabile depind de furnizorul netipificat. Pentru JSON, valorile JSON boolean true, false și null sunt acceptate, correspunzând valorilor true, false și blank în Power Fx. Valorile șirurilor sau numerelor sunt acceptate așa cum este descris pentru supraîncărcările String și Number descrise mai devreme.

Exemple

Utilizare de bază

Formula Descriere Rezultat
Boolean( "true" ) Convertește șirul de text "true" la o valoare boolean. true
Boolean( "false" ) Convertește șirul de text "false" la o valoare boolean. false
Boolean( "TRUE" ) Convertește șirul de text "TRUE" la o valoare boolean. true
Boolean( "TrUe" ) Convertește șirul de text "TrUe" la o valoare boolean. true
Boolean( "Truthful" ) Încercările de a converti șirul de text "Truthful" într-o valoare booleană, dar deoarece nu este o variație care nu face distincție între majuscule și minuscule a true și false, este returnată o eroare. error (argument invalid)
Boolean( Blank() ) Convertește valoarea blank la o valoare booleană. blank
Boolean( 0 ) Convertește numărul 0 la o valoare booleană. false
Boolean( 1 ) Convertește numărul 1 la o valoare booleană. true
Boolean( -1234 ) Convertește numărul -1234 la o valoare booleană. true

Utilizare netipificată

Formula Descriere Rezultat
Boolean( ParseJSON( "{ ""bool"": true }" ).bool ) Convertește valoarea netipificată true (o booleană JSON) într-o valoare booleană. true
Boolean( ParseJSON( "{ ""bool"": null }" ).bool ) Convertește valoarea netipificată null (un null JSON) într-o valoare booleană. blank
Boolean( ParseJSON( "{ ""bool"": "true" }" ).bool ) Încercările de a converti valoarea netipificată "true" (un șir JSON) într-o valoare booleană, dar deoarece nu este o valoare booleană validă în JSON, este returnată o eroare. error (argument invalid)
Boolean( ParseJSON( "[ true, false, null ]" ).bool ) Încercările de a converti o matrice de valori booleene într-un tabel cu o singură coloană. Tabelele cu o singură coloană nu sunt acceptate cu valori netipizate și, în schimb, trebuie utilizată formula ForAll( Table(ParseJSON( "[true, false, null]" )), Boolean( ThisRecord.Value ) ) sau ForAll( ParseJSON( "[true, false, null]" ), Boolean( ThisRecord ) ). error (argument invalid)

Tabele cu o singură coloană

Formula Descriere Rezultat
Boolean( [ "true", "false", Blank() ] ) Convertește tabelul cu o singură coloană de șiruri de text într-un tabel cu o singură coloană de valori booleene. [ true, false, blank ]
Boolean( [ "true", "falsified" ] ) Convertește tabelul cu o singură coloană de șiruri de text într-un tabel cu o singură coloană de valori booleene. Deoarece a doua înregistrare din acest tabel nu este o variație care nu ține seama de majuscule și minuscule pentru true și false, este returnată o eroare pentru această înregistrare. [ true, error (invalid argument) ]
Boolean( [ 1, 2, 0 ] ) Convertește tabelul cu o singură coloană de numere într-un tabel cu o singură coloană de valoare boolean. [ true, true, false ]