Compartilhar via

Boolean Função

Aplica-se a: Aplicativos de tela Copilot Studio Desktop flui aplicativos baseados em modelo CLI CLI Dataverse funções Power Pages

Converta um texto, um número ou um valor dinâmico em um Boolean valor.

Description

Use a Boolean função para converter outros tipos em um Boolean valor. Um Boolean valor é verdadeiro, falso ou em branco.

Na maioria dos casos, a coerção de tipo ocorre automaticamente e você não precisa usar a Boolean função explicitamente. Por exemplo, If( "true", 1, 0 ) retorna 1 porque a cadeia de "true" caracteres de texto é convertida automaticamente em um Boolean. A Boolean função é útil quando você deseja uma conversão explícita ou quando você usa um valor dinâmico.

Sintaxe

Boolean( Texto )
Boolean( TextSingleColumnTable )

  • Texto - Obrigatório. As cadeias de caracteres a serem convertidas. Deve ser uma versão que não diferencia maiúsculas de minúsculas de "true" ou "false". Essas cadeias de caracteres de texto não são localizadas. texto em branco e vazio também é aceito e convertido em branco. Todas as outras cadeias de caracteres de texto retornam um erro.

Boolean( Número )
Boolean( NumberSingleColumnTable )

  • Número - Obrigatório. Os números a serem convertidos. 0 é convertido para falso e todos os outros números são convertidos para verdadeiro. valores em branco são aceitos e convertidos em um espaço em branco.

Boolean( DynamicValue )

  • DynamicValue – Obrigatório. O valor dinâmico a ser convertido. Os valores aceitáveis dependem do provedor dinâmico. Para JSON, os valores boolianos JSON true, false e null são aceitos, correspondendo aos valores true, false e blank no Power Fx. Os valores de cadeia de caracteres ou número são aceitos conforme descrito para as sobrecargas de Cadeia de Caracteres e Número descritas anteriormente.

Exemplos

Uso básico

Fórmula Description Result
Boolean( "true" ) Converte a cadeia de caracteres de texto "true" em um valor booliano. verdadeiro
Boolean( "false" ) Converte a cadeia de caracteres de texto "false" em um valor booliano. falso
Boolean( "TRUE" ) Converte a cadeia de caracteres de texto "TRUE" em um valor booliano. verdadeiro
Boolean( "TrUe" ) Converte a cadeia de caracteres de texto "TrUe" em um valor booliano. verdadeiro
Boolean( "True" ) Tenta converter a cadeia de caracteres de texto "Truthful" em um valor booliano, mas como não é uma variação que não diferencia maiúsculas de minúsculas de true e false, um erro é retornado. erro (argumento inválido)
Boolean( Blank() ) Converte o valor em branco em um valor booliano. em branco
Boolean( 0 ) Converte o número 0 em um valor booliano. falso
Boolean( 1 ) Converte o número 1 em um valor booliano. verdadeiro
Boolean( -1234 ) Converte o número -1234 em um valor booliano. verdadeiro

Uso dinâmico

Fórmula Description Result
Boolean( ParseJSON( "{ ""bool"": true }" ).bool ) Converte o valor true dinâmico (um JSON Boolean) em um valor booliano. verdadeiro
Boolean( ParseJSON( "{ ""bool"": null }" ).bool ) Converte o valor null dinâmico (um nulo JSON) em um valor booliano. em branco
Boolean( ParseJSON( "{ ""bool"": "true" }" ).bool ) Tenta converter o valor "true" dinâmico (uma cadeia de caracteres JSON) em um valor booliano, mas como ele não é um valor booliano válido no JSON, um erro é retornado. erro (argumento inválido)
Boolean( ParseJSON( "[ true, false, null ]" ).bool ) Tenta converter uma matriz de valores boolianos em uma tabela de coluna única. Não há suporte para tabelas de coluna única com valores dinâmicos e, em vez disso, a fórmula ForAll( Table(ParseJSON( "[true, false, null]" )), Boolean( ThisRecord.Value ) ) ou ForAll( ParseJSON( "[true, false, null]" ), Boolean( ThisRecord ) ) deve ser usada. erro (argumento inválido)

Tabelas de coluna única

Fórmula Description Result
Boolean( [ "true", "false", Blank() ] ) Converte a tabela de coluna única de cadeias de caracteres de texto em uma tabela de coluna única de valores boolianos. [ true, false, blank ]
Boolean( [ "true", "falsified" ] ) Converte a tabela de coluna única de cadeias de caracteres de texto em uma tabela de coluna única de valores boolianos. Como o segundo registro nesta tabela não é uma variação que não diferencia maiúsculas de minúsculas de true e false, um erro será retornado para esse registro. [ true, error (argumento inválido) ]
Boolean( [ 1, 2, 0 ] ) Converte a tabela de números de coluna única em uma única tabela de colunas de valores boolianos. [ true, true, false ]
  • Last updated on