Поделиться через


Boolean функция

Применимо к: Приложения На основе холста Copilot Studio Desktop поддерживают функции Power Platform CLI Dataverse, управляемые моделью

Преобразование текста, числа или динамического Boolean значения в значение.

Description

Используйте функцию Boolean для преобразования других типов в Boolean значение. Boolean Значение равно true, false или пусто.

В большинстве случаев приведение типов происходит автоматически, и вам не нужно явно использовать функцию Boolean . Например, возвращает значение 1, If( "true", 1, 0 ) так как текстовая строка "true" автоматически преобразуется в объект Boolean. Функция Boolean полезна, если требуется явное преобразование или при использовании динамического значения.

Синтаксис

Boolean( текст )
Boolean( TextSingleColumnTable )

  • Текст — обязательный. Строки для преобразования. Должна быть версия без учета регистра "true" или "false". Эти текстовые строки не локализованы. Пустой и пустой текст также принимается и преобразуется в пустой. Все остальные текстовые строки возвращают ошибку.

Boolean( Число )
Boolean( NumberSingleColumnTable )

  • Номер - Обязательно. Числа для преобразования. 0 преобразуется в ложь , а все остальные числа преобразуются в истину. пустые значения принимаются и преобразуются в пустые.

Boolean( DynamicValue )

  • DynamicValue — обязательный. Динамическое значение для преобразования. Допустимые значения зависят от динамического поставщика. Для JSON логические значения JSON true, false и null принимаются и соответствуют значениям true, false и пусто в Power Fx. Строковые или числовые значения принимаются, как описано для перегрузок Строка и Число, описанных ранее.

Примеры

Базовое использование

Формула Description Result
Boolean( true) Преобразует значение текстовой строки "true" в логическое значение. истинный
Boolean( false) Преобразует значение текстовой строки "false" в логическое значение. ЛОЖЬ
Boolean( "TRUE" ) Преобразует значение текстовой строки "TRUE" в логическое значение. истинный
Boolean( "TrUe" ) Преобразует значение текстовой строки "TrUe" в логическое значение. истинный
Boolean( "Правда" ) Попытки преобразовать текстовую строку "Truthful" в логическое значение, но так как это не нечувствительный к регистру вариант значений true и false, то возвращается ошибка. ошибка (неверный аргумент)
Boolean( Blank() ) Преобразует пустое значение в логическое значение. пустой
Boolean( 0 ) Преобразует число 0 в логическое значение. ЛОЖЬ
Boolean( 1 ) Преобразует число 1 в логическое значение. истинный
Boolean( -1234 ) Преобразует число -1234 в логическое значение. истинный

Динамическое использование

Формула Description Result
Boolean( ParseJSON( "{ "bool": true }" ).bool ) Преобразует динамическое значение true (JSON Boolean) в логическое значение. истинный
Boolean( ParseJSON( "{ "bool": null }" .bool ) Преобразует динамическое значение null (ЗНАЧЕНИЕ JSON NULL) в логическое значение. пустой
Boolean( ParseJSON( "{ "bool": "true" }" ).bool ) Пытается преобразовать динамическое значение "true" (строку JSON) в логическое значение, но так как оно не является допустимым логическим значением в JSON, возвращается ошибка. ошибка (неверный аргумент)
Boolean( ParseJSON( "[ true, false, null ]" ).bool ) Пытается преобразовать массив логических значений в таблицу с одним столбцом. Таблицы с одним столбцом не поддерживаются динамическими значениями, а вместо формулы ForAll( Table(ParseJSON( "[true, false, null]" )), Boolean( ThisRecord.Value ) ) или ForAll( ParseJSON( "[true, false, null]" ), Boolean( ThisRecord ) ) должны использоваться. ошибка (неверный аргумент)

Таблицы с одним столбцом

Формула Description Result
Boolean( [ "true", "false", Blank() ] Преобразует таблицу текстовых строк с одним столбцом в таблицу логических значений с одним столбцом. [ true, false, пусто ]
Boolean( [ "true", "фальсифицировано" ] ) Преобразует таблицу текстовых строк с одним столбцом в таблицу логических значений с одним столбцом. Поскольку вторая запись в этой таблице не является нечувствительной к регистру вариацией значения true и false, то для этой записи возвращается ошибка. [ true, ошибка (недопустимый аргумент) ]
Boolean( [ 1, 2, 0 ] ) Преобразует таблицу чисел одного столбца в одну таблицу столбцов логических значений. [ true, true, false ]