Partilhar via

Boolean Função

Aplica-se a: Aplicativos de tela Copilot Studio Fluxos de ambiente de trabalho Aplicações orientadas por modelos Funções do Power Platform CLI Dataverse Power Pages

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

Descrição

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 acontece automaticamente, e você não precisa usar a Boolean função explicitamente. Por exemplo, If( "true", 1, 0 ) retorna 1 porque a cadeia de caracteres "true" de texto é convertida automaticamente em um Booleanarquivo . 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. A(s) cadeia(s) a converter. Tem de ser uma versão que não seja sensível às maiúsculas e minúsculas de "true" ou "false". Essas cadeias de caracteres de texto não estão localizadas. Texto em branco e vazio também é aceito e convertido em branco. Todas as outras cadeias de texto obtêm um erro.

Boolean( Número )
Boolean( NumberSingleColumnTable )

  • Número - Obrigatório. O(s) número(s) a converter. 0 é convertido em falso e todos os outros números são convertidos em verdadeiros. valores em branco são aceitos e convertidos em branco .

Boolean( Valor Dinâmico )

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

Exemplos

Utilização básica

Fórmula Descrição Resultado
Boolean( "verdadeiro" ) Converte a cadeia de texto "true" para um valor booleano. verdadeiro
Boolean( "falso" ) Converte a cadeia de texto "false" para um valor booleano. falso
Boolean( "VERDADEIRO" ) Converte a cadeia de texto "TRUE" para um valor booleano. verdadeiro
Boolean( "TrUe" ) Converte a cadeia de texto "TrUe" para um valor booleano. verdadeiro
Boolean( "Verdadeiro" ) Tenta converter a cadeia de texto "Truthful" num valor booleano, mas, visto que não é uma variação que não é sensível às maiúsculas e minúsculas de true e false, é obtido um erro. erro (argumento inválido)
Boolean( Em branco() ) Converte o valor em branco em um valor booleano. em branco
Boolean( 0 ) Converte o número 0 em um valor booleano. falso
Boolean( 1 ) Converte o número 1 em um valor booleano. verdadeiro
Boolean( -1234 ) Converte o número -1234 em um valor booleano. verdadeiro

Utilização dinâmica

Fórmula Descrição Resultado
Boolean( ParseJSON( "{ ""bool"": true }" ).bool ) Converte o valor true dinâmico (um JSON Boolean) em um valor booleano. verdadeiro
Boolean( ParseJSON( "{ ""bool"": null }" ).bool ) Converte o valor null dinâmico (um JSON null) em um valor booleano. em branco
Boolean( ParseJSON( "{ ""bool"": "verdadeiro" }" ).bool ) Tenta converter o valor "true" dinâmico (uma cadeia de caracteres JSON) em um valor booleano, mas como não é um valor booleano válido em JSON, um erro é retornado. erro (argumento inválido)
Boolean( ParseJSON( "[ verdadeiro, falso, nulo ]" ).bool ) Tenta converter uma matriz de valores booleanos numa tabela de coluna única. As tabelas de coluna única não são suportadas 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 Descrição Resultado
Boolean( [ "verdadeiro", "falso", em branco() ) Converte a tabela de coluna única de cadeias de texto numa tabela de coluna única de valores booleano. [ verdadeiro, falso, em branco ]
Boolean( [ "verdadeiro", "falsificado" ] ) Converte a tabela de coluna única de cadeias de texto numa tabela de coluna única de valores booleano. Uma vez que o segundo registo nesta tabela não é uma variação que não é sensível às maiúsculas e minúsculas de true e false, é obtido um erro para este registo. [ true, erro (argumento inválido) ]
Boolean( [ 1, 2, 0 ] ) Converte a tabela de números de coluna única em uma tabela de coluna única de valores booleanos. [ verdadeiro, verdadeiro, falso ]
  • Last updated on