Boolean Función

Aplícase a: Aplicacións de lenzo Copilot Studio Fluxos de escritorio Aplicacións baseadas en modelos Power Platform CLI Dataverse funcións Power Pages

Converte un texto, un número ou un valor dinámico nun Boolean valor.

Descripción

Usa a Boolean función para converter outros tipos nun Boolean valor. Un Boolean valor é verdadeiro, falso ou en branco.

Na maioría dos casos, a coerción de tipos ocorre automaticamente e non é necesario usar a Boolean función explicitamente. Por exemplo, If( "true", 1, 0 ) devolve 1 porque a cadea "true" de texto convértese automaticamente en .Boolean A Boolean función é útil cando se quere unha conversión explícita ou cando se usa un valor dinámico.

Sintaxe

Boolean( Texto )
Boolean( TextSingleColumnTable )

  • Texto - 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 de texto non están localizadas. O texto en branco e baleiro tamén se acepta e convértese en branco. Todas as outras cadeas de texto devolven un erro.

Boolean( Número )
Boolean( NumberSingleColumnTable )

  • Número : obrigatorio. Os números que hai que converter. 0 convé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.

Boolean( DynamicValue )

  • DynamicValue - Obrigatorio. O valor dinámico para converter. Os valores aceptables dependen do provedor dinámico. Para JSON, acéptanse os valores booleanos JSON true, false e null, 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( "Verdadeiro") 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)
Boolean( Blank () ) Converte o valor en branco nun valor booleano. en branco
Boolean( 0 ) Converte o número 0 nun valor booleano. falso
Boolean( 1 ) Converte o número 1 nun valor booleano. verdade
Boolean( -1234 ) Converte o número -1234 nun valor booleano. verdade

Uso dinámico

Fórmula Descripción Resultado
Boolean( ParseJSON( "{ "bool"": true }" ).bool ) Converte o valor true dinámico (un JSON Boolean) nun valor booleano. verdade
Boolean( ParseJSON( "{ "bool"": null }" ).bool ) Converte o valor null dinámico (un JSON nulo) nun valor booleano. en branco
Boolean( ParseJSON( "{ "bool"": "true" }" ).bool ) Intenta converter o valor "true" dinámico (unha cadea JSON) nun valor booleano, pero como non é un valor booleano válido en JSON, devértese 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 están soportadas con valores dinámicos, senón que a fórmula ForAll( Table(ParseJSON( "[true, false, null]" )), Boolean( ThisRecord.Value ) ) ou ForAll( ParseJSON( "[true, false, null]" ), Boolean( ThisRecord ) ) debe usarse. erro (argumento non válido)

Táboas dunha soa columna

Fórmula Descripción Resultado
Boolean( [ "verdadeiro", "falso", Blank() ) Converte a táboa dunha soa columna de cadeas de texto nunha táboa dunha soa columna de valores booleanos. [ verdadeiro, falso, en branco ]
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) ]
Boolean( [ 1, 2, 0 ] ) Converte a táboa de números dunha soa columna nunha táboa de valores booleanos. [ verdadeiro, verdadeiro, falso ]