Función booleana
Aplícase a:
Aplicacións de lenzo Fluxos de escritorio Aplicacións baseadas en modelos Power Pages Power Platform CLI
Converte unha cadea de texto, un número ou un valor sen escribir nun valor booleano.
Descripción
Use a función Booleana para converter outros tipos nun valor booleano. O valor booleano é true, false ou en branco.
Na maioría dos casos, a coerción do tipo ocorre automaticamente e non é necesario utilizar a función booleana de forma explícita. Por exemplo, If( "true", 1, 0 ) devolverá 1 xa que a cadea de texto "true" convértese automaticamente nun booleano. A función booleana é útil cando se desexa unha conversión explícita ou cando se utiliza un valor sen escribir.
Sintaxe
Booleano( Cadea )
Booleano( StringSingleColumnTable )
- Cadena - Obrigatorio. As cadeas que hai que converter. Debe ser unha versión que non distingue entre maiúsculas e minúsculas de
"true"ou"false". Estas cadeas non están localizadas. As cadeas en branco e baleiras tamén se aceptan e convértense nun en branco. Todas as outras cadeas de texto devolven un erro.
Booleano( Número )
Booleano( NumberSingleColumnTáboa )
- Número : obrigatorio. Os números que hai que converter.
0convértese en false e todos os demais números convértense en true. Os valores en branco acéptanse e convértense nun en branco.
Booleano( Sen tipificación )
- Sen escribir : é necesario. O valor sen escribir para converter. Os valores aceptables dependen do provedor non tipificado. Para JSON, acéptanse os valores booleanos JSON
true,falseenull, correspondentes aos valores de true, false e blank en Power Fx. Os valores de cadea ou de número acéptanse como se indica para as sobrecargas Cadea e Número descritas anteriormente.
Exemplos
Uso básico
| Fórmula | Descripción | Resultado |
|---|---|---|
| Boolean("verdadeiro") | Converte a cadea de texto "true" nun valor booleano. |
verdade |
| Boolean("falso") | Converte a cadea de texto "false" nun valor booleano. |
falso |
| Boolean("VERDADEIRO") | Converte a cadea de texto "TRUE" nun valor booleano. |
verdade |
| Boolean("TrUe") | Converte a cadea de texto "TrUe" nun valor booleano. |
verdade |
| Boolean("Verdadero") | Inténtase converter a cadea de texto "Truthful" a un valor booleano, pero como non é unha variación que non distingue entre maiúsculas e minúsculas de true e false, devólvese un erro. |
erro (argumento non válido) |
| Booleano(Baleiro()) | Converta o valor blank nun valor booleano. | en branco |
| Booleano (0) | Converta o número 0 nun valor booleano. |
falso |
| Booleano (1) | Converta o número 1 nun valor booleano. |
verdade |
| Booleano (-1234) | Converta o número -1234 nun valor booleano. |
verdade |
Uso non tipificado
| Fórmula | Descripción | Resultado |
|---|---|---|
| Booleano( ParseJSON( "{ ""bool"": true }" ).bool ) | Converte o valor non tipificado true (un booleano JSON) nun valor booleano. |
verdade |
| Boolean( ParseJSON( "{ ""bool"": null }" ).bool ) | Converte o valor non tipificado null (un JSON nulo) nun valor booleano. |
en branco |
| Boolean( ParseJSON( "{ ""bool"": "true" }" ).bool ) | Intenta converter o valor non tipificado "true" (unha cadea JSON) nun valor booleano, pero como non é un valor booleano válido en JSON, devólvese un erro. |
erro (argumento non válido) |
| Boolean( ParseJSON( "[ verdadeiro, falso, nulo ] " ).bool ) | Intenta converter unha matriz de valores booleanos nunha táboa de columna única. As táboas dunha soa columna non se admiten con valores non tipificados, polo que debería utilizarse a fórmula ForAll( Table(ParseJSON( "[true, false, null]" )), Boolean( ThisRecord.Value ) ) ou ForAll( ParseJSON( "[true, false, null]" ), Boolean( ThisRecord ) ). |
erro (argumento non válido) |
Táboas dunha soa columna
| Fórmula | Descripción | Resultado |
|---|---|---|
| Boolean([ "verdadeiro", "falso", en branco () ] ) | Converte a táboa dunha soa columna de cadeas de texto nunha táboa dunha soa columna de valores booleanos. | [ true, false, blank ] |
| Boolean([ "verdadeiro", "falsificado" ] ) | Converte a táboa dunha soa columna de cadeas de texto nunha táboa dunha soa columna de valores booleanos. Dado que o segundo rexistro desta táboa non é unha variación que non distingue entre maiúsculas e minúsculas de true e false, devólvese un erro para este rexistro. |
[ true, erro (argumento non válido) ] |
| Booleano ( [ 1, 2, 0 ] ) | Converte a táboa dunha soa columna de números nunha táboa dunha soa columna de valores booleanos. | [ true, true, false ] |