Comparteix a través de

Funció booleana

  • Article

S'aplica a: Aplicacions de llenç Fluxos d'escriptori Aplicacions Power Pages Power Platform basades en models CLI

Converteix una cadena de text, un número o un valor sense tipus en un valor booleà.

Descripció

Utilitzeu la funció Boolean per convertir altres tipus en un valor booleà. Un valor booleà és true, false o en blanc.

En la majoria dels casos, la coacció de tipus es produeix automàticament i la funció Boolean no s'ha d'utilitzar explícitament. Per exemple, If( "true", 1, 0 ) retornarà 1, ja que la cadena de text "true" es converteix automàticament en un booleà. La funció Boolean és útil quan es desitja una conversió explícita o quan s'utilitza un valor no sense tipus.

Sintaxi

Booleà( String )
Booleà ( StringSingleColumnTable )

  • Cadena: obligatori. Les cadenes que es converteixen. Ha de ser una versió que no distingeixi entre majúscules i minúscules de "true" o "false". Aquestes cadenes no estan traduïdes. La cadena en blanc i buida també s'accepta i es converteix en un blanc. La resta de cadenes de text retornen un error.

Booleà( Number )
Booleà ( NumberSingleColumnTable )

  • Número: obligatori. Els nombres que es convertiran. 0 es converteix en false i la resta de números es converteixen en true. Els valors en blanc s'accepten i es converteixen en un blanc.

Booleà( Untyped )

  • Sense tipus: obligatori. El valor sense tipus que es convertirà. Els valors acceptables depenen del proveïdor sense tipus. Per a JSON, els valors booleans JSON true, false i null i s'accepten, corresponents als valors true, false i en blanc al Power Fx. Els valors de cadena o número s'accepten tal com s'indica per a les sobrecàrregues de cadena i número descrites anteriorment.

Exemples

Ús bàsic

Fórmula Descripció Resultat
Boolean( "true" ) Converteix una cadena de text "true" en un valor booleà. true
Boolean( "false" ) Converteix una cadena de text "false" en un valor booleà. fals
Boolean( "TRUE" ) Converteix una cadena de text "TRUE" en un valor booleà. true
Boolean( "TrUe" ) Converteix una cadena de text "TrUe" en un valor booleà. true
Boolean( "Truthful" ) Intenta convertir la cadena de text "Truthful" en un valor booleà, però com que no es tracta d'una variació que distingeix entre majúscules i minúscules de true i false, es torna un error. error (argument no vàlid)
Boolean( Blank() ) Convertiu el valor en blanc en un valor booleà. blank
Boolean( 0 ) Convertiu el nombre 0 en un valor booleà. fals
Boolean( 1 ) Convertiu el nombre 1 en un valor booleà. true
Boolean( -1234 ) Convertiu el nombre -1234 en un valor booleà. true

Ús sense tipus

Fórmula Descripció Resultat
Boolean( ParseJSON( "{ ""bool"": true }" ).bool ) Converteix el valor sense tipus true (un booleà JSON) en un valor booleà. true
Boolean( ParseJSON( "{ ""bool"": null }" ).bool ) Converteix el valor sense tipus null (un JSON nul) en un valor booleà. blank
Boolean( ParseJSON( "{ ""bool"": "true" }" ).bool ) Intenta convertir el valor sense tipus "true" (una cadena JSON) en un valor booleà, però com que no és un valor booleà vàlid al JSON, es torna un error. error (argument no vàlid)
Boolean( ParseJSON( "[ true, false, null ]" ).bool ) Intenta convertir una matriu de valors booleans en una única taula de columnes. Les taules d'una única columna no estan admeses amb valors sense tipus i, en lloc d'això, s'ha d'utilitzar la fórmula ForAll( Table(ParseJSON( "[true, false, null]" )), Boolean( ThisRecord.Value ) ) o ForAll( ParseJSON( "[true, false, null]" ), Boolean( ThisRecord ) ). error (argument no vàlid)

Taules d'una sola columna

Fórmula Descripció Resultat
Boolean( [ "true", "false", Blank() ] ) Converteix la taula d'una única columna de cadenes de text en una única taula de columnes de valors booleans. [ true, false, blank ]
Boolean( [ "true", "falsified" ] ) Converteix la taula d'una única columna de cadenes de text en una única taula de columnes de valors booleans. Com que el segon registre d'aquesta taula no és un fet que distingeixi entre majúscules i minúscules de true i false, es retorna un error per a aquest registre. [ true, error (argument no vàlid) ]
Boolean( [ 1, 2, 0 ] ) Converteix la taula d'una única columna de nombres en una taula d'una columna de valors booleans. [ true, true, false ]