Udostępnij przez


Funkcja Boolean

Dotyczy: Aplikacje kanwy Copilot Studio Desktop przepływy oparte na modelu Aplikacje oparte na modelu Interfejs wiersza polecenia platformy PowerVerse funkcje Power Pages

Przekonwertuj wartość tekstową, liczbę lub dynamiczną Boolean na wartość.

opis

Boolean Użyj funkcji , aby przekonwertować inne typy na Boolean wartość. Wartość Boolean to true, false lub blank.

W większości przypadków wymuszanie typu odbywa się automatycznie i nie trzeba jawnie używać Boolean funkcji. Na przykład zwraca wartość 1, If( "true", 1, 0 ) ponieważ ciąg "true" tekstowy jest automatycznie konwertowany na Boolean. Funkcja jest przydatna Boolean , gdy ma być jawna konwersja lub gdy używasz wartości dynamicznej.

Składnia

Boolean( Tekst )
Boolean( TextSingleColumnTable )

  • Tekst - wymagane. Ciąg, który ma zostać przekonwertowany. Musi to być wersja bez rozróżniania wielkości liter "true" lub "false". Te ciągi tekstowe nie są zlokalizowane. pusty i pusty tekst jest również akceptowany i konwertowany na pusty. Wszystkie inne ciągi tekstowe zawierają błąd.

Boolean( Liczba )
Boolean( NumberSingleColumnTable )

  • Liczba - Wymagane. Liczby do konwersji. 0 jest konwertowany na wartość false , a wszystkie inne liczby są konwertowane na wartość true. Wartości puste są akceptowane i konwertowane na wartości puste.

Boolean( DynamicValue )

  • DynamicValue — wymagane. Wartość dynamiczna do przekonwertowania. Dopuszczalne wartości zależą od dostawcy dynamicznego. Dla JSON wartości logiczne JSON true, false i null są akceptowalne, co odpowiada wartościom true, false i blank w Power Fx. Wartości ciągów lub liczb są zaakceptowane jak wcześniej opisano w przeciążeniach Ciąg i Numer.

Przykłady

Podstawowy sposób użycia

Formuła opis Result
Boolean( "true" ) Konwertuje ciąg tekstowy "true" na wartość logiczną. prawdziwy
Boolean( "false" ) Konwertuje ciąg tekstowy "false" na wartość logiczną. fałszywy
Boolean( "TRUE" ) Konwertuje ciąg tekstowy "TRUE" na wartość logiczną. prawdziwy
Boolean( "TrUe" ) Konwertuje ciąg tekstowy "TrUe" na wartość logiczną. prawdziwy
Boolean( "Prawda" ) Próbuje przekonwertować ciąg tekstowy "Truthful" na wartość logiczną, ale ponieważ nie jest to odmiana true i false, która nie uwzględnia wielkości liter, zwracany jest błąd. Błąd (nieprawidłowy argument)
Boolean( Blank() ) Konwertuje wartość pustą na wartość logiczną . pusty
Boolean( 0 ) Konwertuje liczbę 0 na wartość logiczną. fałszywy
Boolean( 1 ) Konwertuje liczbę 1 na wartość logiczną. prawdziwy
Boolean( -1234 ) Konwertuje liczbę -1234 na wartość logiczną. prawdziwy

Użycie dynamiczne

Formuła opis Result
Boolean( ParseJSON( "{ ""bool": true }" ).bool ) Konwertuje wartość true dynamiczną (JSON Boolean) na wartość logiczną. prawdziwy
Boolean( ParseJSON( "{ ""bool":null }" ).bool ) Konwertuje wartość null dynamiczną (wartość null JSON) na wartość logiczną. pusty
Boolean( ParseJSON( "{ ""bool"": "true" }" ).bool ) Próbuje przekonwertować wartość "true" dynamiczną (ciąg JSON) na wartość logiczną, ale ponieważ nie jest to prawidłowa wartość logiczna w formacie JSON, zwracany jest błąd. Błąd (nieprawidłowy argument)
Boolean( ParseJSON( "[ true, false, null ]" ).bool ) Próbuje przekonwertować tablicę wartości logicznych na tabelę w jednej kolumnie. Tabele z jedną kolumną nie są obsługiwane z wartościami dynamicznymi, a zamiast tego formuła ForAll( Table(ParseJSON( "[true, false, null]" )), Boolean( ThisRecord.Value ) ) lub ForAll( ParseJSON( "[true, false, null]" ), Boolean( ThisRecord ) ) powinna być używana. Błąd (nieprawidłowy argument)

Tabele jednokolumnowe

Formuła opis Result
Boolean( [ "true", "false", Blank() ] ) Konwertowanie tabeli pojedynczej kolumny z ciągami tekstowymi na jedną kolumnę wartości logicznych. [ true, false, blank ]
Boolean( [ "true", "sfałszowany" ] ) Konwertowanie tabeli pojedynczej kolumny z ciągami tekstowymi na jedną kolumnę wartości logicznych. Ponieważ drugi rekord w tej tabeli nie jest odmianą true i false bez rozróżniania wielkości liter, dla tego rekordu zwracany jest błąd. [ true, error (błędny argument) ]
Boolean( [ 1, 2, 0 ] ) Konwertuje jednokolumnową tabelę liczb na jednokolumnową tabelę wartości logicznych. [ true, true, false ]