Bagikan melalui


fungsi Boolean

Berlaku untuk: Aplikasi Kanvas Copilot Studio Desktop mengalir aplikasi berbasis model Power Platform CLI Fungsi Dataverse Power Pages

Mengonversi teks, angka, atau nilai dinamis menjadi Boolean nilai.

Description

Boolean Gunakan fungsi untuk mengonversi jenis lain menjadi Boolean nilai. Nilainya Booleanbenar, salah, atau kosong.

Dalam kebanyakan kasus, koersi jenis terjadi secara otomatis, dan Anda tidak perlu menggunakan fungsi secara Boolean eksplisit. Misalnya, If( "true", 1, 0 ) mengembalikan 1 karena string "true" teks secara otomatis dikonversi ke Boolean. Fungsi Boolean ini berguna saat Anda menginginkan konversi eksplisit atau saat Anda menggunakan nilai dinamis.

Sintaks

Boolean( Teks )
Boolean( TextSingleColumnTable )

  • Teks - Wajib. String yang akan dikonversi. Harus merupakan versi yang tidak peka besar huruf "true" atau "false". String teks ini tidak dilokalkan. teks kosong dan kosong juga diterima dan dikonversi menjadi kosong. Semua string teks lainnya menghasilkan kesalahan.

Boolean( Nomor )
Boolean( NumberSingleColumnTable )

  • Nomor - Wajib. Angka yang akan dikonversikan. 0 diubah menjadi false dan semua angka lainnya diubah menjadi true. nilai kosong diterima dan dikonversi menjadi kosong.

Boolean( DynamicValue )

  • DynamicValue - Diperlukan. Nilai dinamis yang akan dikonversi. Nilai yang dapat diterima bergantung pada penyedia dinamis. Untuk JSON, nilai boolean JSON true, false, dan null diterima, sesuai dengan nilai true, false, dan blank di Power Fx. Nilai string atau angka diterima seperti yang diuraikan untuk kelebihan beban String dan Angka yang dijelaskan sebelumnya.

Contoh

Penggunaan dasar

Rumus Description Hasil
Boolean("benar" ) Mengonversi string teks "true" ke nilai Boolean. benar
Boolean("false" ) Mengonversi string teks "false" ke nilai Boolean. palsu
Boolean("BENAR" ) Mengonversi string teks "TRUE" ke nilai Boolean. benar
Boolean("TrUe" ) Mengonversi string teks "TrUe" ke nilai Boolean. benar
Boolean("Jujur" ) Upaya mengkonversi string teks "Truthful" ke nilai boolean, tetapi karena ini bukan variasi yang tidak peka huruf true dan false, kesalahan dihasilkan. error (argumen tidak valid)
Boolean(Kosong() ) Mengonversi nilai kosong menjadi nilai boolean. Kosong
Boolean( 0 ) Mengonversi angka 0 menjadi nilai boolean. palsu
Boolean( 1 ) Mengonversi angka 1 menjadi nilai boolean. benar
Boolean(-1234) Mengonversi angka -1234 menjadi nilai boolean. benar

Penggunaan dinamis

Rumus Description Hasil
Boolean( ParseJSON( "{ ""bool":true }" ).bool ) Mengonversi nilai true dinamis (JSON Boolean) menjadi nilai boolean. benar
Boolean( ParseJSON( "{ ""bool"": null }" ).bool ) Mengonversi nilai null dinamis (JSON null) menjadi nilai boolean. Kosong
Boolean( ParseJSON( "{ ""bool": "true" }" ).bool ) Mencoba mengonversi nilai "true" dinamis (string JSON) menjadi nilai boolean, tetapi karena bukan nilai boolean yang valid di JSON, kesalahan dikembalikan. error (argumen tidak valid)
Boolean( ParseJSON( "[ true, false, null ]" ).bool ) Upaya mengkonversi larik nilai boolean ke tabel kolom tunggal. Tabel kolom tunggal tidak didukung dengan nilai dinamis, dan sebagai gantinya rumus ForAll( Table(ParseJSON( "[true, false, null]" )), Boolean( ThisRecord.Value ) ) atau ForAll( ParseJSON( "[true, false, null]" ), Boolean( ThisRecord ) ) harus digunakan. error (argumen tidak valid)

Tabel kolom tunggal

Rumus Description Hasil
Boolean( [ "true", "false", Blank() ] ) Mengkonversi tabel kolom tunggal string teks ke tabel kolom tunggal dari nilai boolean. [ benar, salah, kosong ]
Boolean( [ "benar", "dipalsukan" ] ) Mengkonversi tabel kolom tunggal string teks ke tabel kolom tunggal dari nilai boolean. Karena rekaman kedua dalam tabel ini bukan variasi kasus yang tidak peka huruf true dan false, kesalahan akan dihasilkan untuk rekaman ini. [ true, kesalahan (argumen tidak valid) ]
Boolean( [ 1, 2, 0 ] ) Mengonversi tabel kolom tunggal angka menjadi tabel kolom tunggal nilai boolean. [ benar, benar, salah ]