Partager via


Boolean Fonction

S’applique à : Les applications Canvas Copilot Studio Desktop circulent des applications basées sur des modèles power Platform CLI Dataverse functions Power Pages

Convertissez un texte, un nombre ou une valeur dynamique en valeur Boolean .

Description

Utilisez la Boolean fonction pour convertir d’autres types en valeur Boolean . Une Boolean valeur est true, false ou vide.

Dans la plupart des cas, la contrainte de type se produit automatiquement et vous n’avez pas besoin d’utiliser la Boolean fonction explicitement. Par exemple, If( "true", 1, 0 ) retourne 1, car la chaîne "true" de texte est automatiquement convertie en .Boolean La Boolean fonction est utile lorsque vous souhaitez une conversion explicite ou lorsque vous utilisez une valeur dynamique.

Syntaxe

Boolean( Texte )
Boolean( TextSingleColumnTable )

  • Texte - Obligatoire. La/es chaîne(s) à convertir. Doit être une version non sensible à la casse de "true" ou "false". Ces chaînes de texte ne sont pas localisées. le texte vide et vide est également accepté et converti en vide. Toutes les autres chaînes de texte renvoient une erreur.

Boolean( Nombre )
Boolean( NumberSingleColumnTable )

  • Numéro - Obligatoire. Le(s) nombre(s) à convertir. 0 est converti en faux et tous les autres nombres sont convertis en vrai. Les valeurs vides sont acceptées et converties en valeurs vides.

Boolean( DynamicValue )

  • DynamicValue - Obligatoire. Valeur dynamique à convertir. Les valeurs acceptables dépendent du fournisseur dynamique. Pour JSON, les valeurs booléennes JSON true, false, et null sont acceptées, correspondant aux valeurs true, false et blank dans Power Fx. Les valeurs de chaîne ou de nombre sont acceptées comme indiqué pour les surcharges Chaîne et Nombre décrites précédemment.

Examples

Utilisation de base

Formula Description Result
Boolean( « true » ) Convertit la chaîne de texte "true" en valeur booléenne. vrai
Boolean( « false » ) Convertit la chaîne de texte "false" en valeur booléenne. FAUX
Boolean( « TRUE » ) Convertit la chaîne de texte "TRUE" en valeur booléenne. vrai
Boolean( « TrUe » ) Convertit la chaîne de texte "TrUe" en valeur booléenne. vrai
Boolean( « Véridique » ) Essaie de convertir la chaîne de texte "Truthful" en valeur booléenne, mais comme elle n’est pas une variante non sensible à la casse de true et false, une erreur est renvoyée. erreur (argument invalide)
Boolean( Blank() ) Convertit la valeur vide en valeur booléenne. vide
Boolean( 0 ) Convertit le nombre 0 en valeur booléenne. FAUX
Boolean( 1 ) Convertit le nombre 1 en valeur booléenne. vrai
Boolean( -1234 ) Convertit le nombre -1234 en valeur booléenne. vrai

Utilisation dynamique

Formula Description Result
Boolean( ParseJSON( « { « "bool" » : true } » ).bool ) Convertit la valeur true dynamique (un JSON Boolean) en valeur booléenne. vrai
Boolean( ParseJSON( « { « "bool" » : null } » ).bool ) Convertit la valeur dynamique (une valeur null JSON Null) en valeur booléenne. vide
Boolean( ParseJSON( « { « "bool" » : « true » } » ).bool ) Tente de convertir la valeur "true" dynamique (une chaîne JSON) en valeur booléenne, mais comme il ne s’agit pas d’une valeur booléenne valide dans JSON, une erreur est retournée. erreur (argument invalide)
Boolean( ParseJSON( « [ true, false, null ] » ).bool ) Essaie de convertir un tableau de valeurs booléennes en une table à une seule colonne. Les tables à colonne unique ne sont pas prises en charge avec des valeurs dynamiques, et à la place la formule ForAll( Table(ParseJSON( "[true, false, null]" )), Boolean( ThisRecord.Value ) ) ou ForAll( ParseJSON( "[true, false, null]" ), Boolean( ThisRecord ) ) doivent être utilisées. erreur (argument invalide)

Tables à une seule colonne

Formula Description Result
Boolean( [ « true », « false », Blank() ] ) Convertit la table à une seule colonne de chaînes de texte en une table à une seule colonne de valeurs booléennes. [ true, false, blank ]
Boolean( [ « true », « falsified » ] ) Convertit la table à une seule colonne de chaînes de texte en une table à une seule colonne de valeurs booléennes. Étant donné que le deuxième enregistrement de cette table n’est pas une variante insensible à la casse de true et false, une erreur est renvoyée pour cet enregistrement. [ true, erreur (argument non valide) ]
Boolean( [ 1, 2, 0 ] ) Convertit la table de colonnes unique de nombres en une seule table de colonnes de valeurs booléennes. [ true, true, false ]