Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Berlaku untuk:
Aplikasi Kanvas Copilot Studio Desktop mengalir kolom rumus Dataverse Aplikasi berbasis model Power Platform CLI Fungsi Dataverse Power Pages
Mengubah semua nilai dan memformat angka atau nilai tanggal/waktu menjadi string teks.
KETERANGAN
Fungsi memformat Text nilai angka atau tanggal/waktu berdasarkan salah satu jenis argumen ini:
- Format tanggal/waktu yang telah ditentukan, yang Anda tentukan menggunakan enumerasi DateTimeFormat. Untuk tanggal dan waktu, pendekatan ini lebih disukai karena secara otomatis disesuaikan dengan bahasa dan kawasan masing-masing pengguna.
- Format kustom, yang terdiri dari serangkaian pengganti yang menentukan, misalnya, apakah angka menunjukkan pemisah desimal dan tanggal menampilkan nama lengkap bulan, bulan sebagai singkatan, atau bulan sebagai angka. Power Apps mendukung subset pengganti yang didukung Microsoft Excel. Dalam string ini, pengganti bahasa menentukan bahasa untuk menafsirkan pengganti lainnya. Jika format kustom mencakup titik, misalnya, pengganti format bahasa menentukan apakah titik adalah pemisah desimal (ja-JP) atau pemisah ribuan (es-ES).
Lihat bekerja dengan tanggal dan waktu untuk informasi lebih lanjut.
Fungsi ini Text juga dapat mengonversi jenis data apa pun menjadi representasi teks menggunakan format default. Gunakan ini untuk meneruskan nilai non-teks ke fungsi berbasis teks seperti Len, Right, dan IsMatch.
Format tanggal/waktu yang telah ditentukan
Untuk contoh ini, tanggal dan waktu yang digunakan adalah Tuesday, April 7, 2020 8:26:59.180 PM, di zona waktu UTC-7 jam.
| Enum DateTimeFormat | KETERANGAN | Contoh (menggunakan en-US) |
|---|---|---|
| Tanggal panjang | Empat digit tahun, nama bulan, hari dalam sebulan, dan hari dalam seminggu. Nama bulan dan hari dalam seminggu tidak disingkat. | "Selasa, 7 April 2020" |
| Waktu Tanggal Panjang | Empat digit tahun, nama bulan, hari dalam sebulan, dan hari dalam seminggu, plus jam (12 jam), menit, detik, dan penyebutan AM/PM. Nama bulan dan hari dalam seminggu tidak disingkat. | "Selasa, 7 April 2020 20:26:59 PM" |
| Waktu Tanggal Panjang24 | Empat digit tahun, bulan, hari dalam sebulan, dan hari dalam seminggu, plus jam (24 jam), menit dan detik. Nama bulan dan hari dalam seminggu tidak disingkat. | "Selasa, 7 April 2020 20:26:59" |
| Lama | Jam (12 jam), menit, detik, dan penyebutan PM/PM. | "8:26:59 PM" |
| Waktu lama24 | Jam (24 jam), menit, detik. | "20:26:59" |
| Tanggal Pendek | Empat digit tahun dengan bulan numerik dan hari dalam sebulan. | "4/7/2020" |
| Waktu Tanggal Pendek | Empat digit tahun dengan bulan numerik dan hari dalam sebulan, plus jam (12 jam), menit dan penyebutan AM/PM. | "7/4/2020 20:26" |
| Waktu Tanggal Pendek24 | Empat digit tahun dengan bulan numerik dan hari dalam sebulan, plus jam (24 jam) dan menit. | "4/7/2020 20:26" |
| Waktu Singkat | Jam (12 jam), menit, dan penyebutan PM/PM. | "20:26" |
| Waktu Singkat24 | Jam (24 jam) dan menit. | "20:26" |
| UTC | Nilai tanggal/waktu dikonversi ke UTC berdasarkan zona waktu pengguna saat ini dan diformat sesuai dengan standar ISO 8601. | "2020-04-08T03:26:59.180Z" |
Placeholder angka
| Placeholder | KETERANGAN |
|---|---|
| 0 (nol) | Menampilkan nol yang tidak signifikan jika angka memiliki lebih sedikit digit daripada nol dalam format. Misalnya, gunakan format #.00 jika Anda ingin menampilkan 8.9 sebagai 8.90. |
| # | Mengikuti aturan yang sama seperti 0 (nol). Namun, Text tidak mengembalikan nol tambahan ketika angka memiliki lebih sedikit digit di salah satu sisi desimal daripada simbol # dalam format. Misalnya, 8.9 ditampilkan jika format kustom adalah #.## dan angka yang akan diformat adalah 8.9. |
| . (titik) | Menampilkan titik desimal dalam angka. Tergantung pada bahasa format kustom; lihat aplikasi global untuk detail lebih lanjut. |
| ,(koma) | Menampilkan pemisah pengelompokan dalam angka, sering digunakan untuk ribuan. Text memisahkan grup menurut koma jika format berisi koma yang diapit oleh tanda angka (#) atau dengan nol. Tergantung pada bahasa format kustom; lihat aplikasi global untuk detail lebih lanjut. |
Jika angka memiliki lebih banyak digit di sebelah kanan titik desimal daripada placeholder dalam format, angka akan dibulatkan ke angka desimal sebanyak jumlah placeholder. Jika ada lebih banyak digit di sebelah kiri titik desimal daripada placeholder, digit tambahan akan ditampilkan. Jika format hanya berisi tanda angka (#) di sebelah kiri titik desimal, angka kurang dari 1 dimulai dengan titik desimal (misalnya, 0,47).
Placeholder tanggal dan waktu
| Placeholder | KETERANGAN |
|---|---|
| m | Menampilkan bulan sebagai angka tanpa awalan nol. |
| mm | Menampilkan bulan sebagai angka dengan awalan nol jika sesuai. |
| mmm | Menampilkan bulan sebagai singkatan (Jan hingga Des). |
| mmmm | Menampilkan bulan sebagai nama lengkap (Januari hingga Desember). |
| d | Menampilkan hari sebagai angka tanpa awalan nol. |
| dd | Menampilkan hari sebagai angka dengan awalan nol jika sesuai. |
| ddd | Menampilkan hari sebagai singkatan (Min hingga Sab). |
| dddd | Menampilkan hari sebagai nama lengkap (Minggu ke Sabtu). |
| yy | Menampilkan tahun sebagai angka dua digit. |
| yyyy | Menampilkan tahun sebagai angka empat digit. |
| h | Menampilkan jam sebagai angka tanpa awalan nol. |
| hh | Menampilkan jam sebagai angka dengan awalan nol jika sesuai. Jika format berisi AM atau PM, jam ditampilkan berdasarkan 12 jam. Jika tidak, jam ditampilkan berdasarkan 24 jam. |
| m | Menampilkan menit sebagai angka tanpa awalan nol. Tempat penampung ini harus muncul segera setelah kode h atau hh atau segera sebelum kode ss ; jika tidak, Text mengembalikan bulan alih-alih menit. |
| mm | Menampilkan menit sebagai angka dengan awalan nol jika sesuai. Placeholder ini harus muncul segera setelah placeholder h atau hh atau tepat sebelum placeholder ss. Jika tidak, Text mengembalikan bulan alih-alih menit. |
| s | Menampilkan detik sebagai angka tanpa awalan nol. |
| ss | Menampilkan detik sebagai angka dengan awalan nol jika sesuai. |
| f | Menampilkan fraksi detik. |
| AM/PM,a/p | Menampilkan jam berdasarkan 12 jam. Text mengembalikan "AM" atau "a" untuk waktu dari tengah malam hingga siang dan "PM" atau "p" untuk waktu dari siang hingga tengah malam |
Placeholder literal
Anda dapat menyertakan salah satu karakter ini dalam string format. Mereka akan muncul dalam hasil Text apa adanya. Karakter tambahan dicadangkan untuk placeholder berikutnya, sehingga Anda tidak boleh menggunakannya.
| Karakter | KETERANGAN |
|---|---|
| Simbol mata uang | Tanda dolar, tanda sen, tanda euro, dll. |
| + | Tanda plus |
| ( | Tanda kurung kiri |
| : | Titik dua |
| ^ | Aksen circumflex (caret) |
| ' | Apostrof |
| { | Tanda kurung kurawal kiri |
| < | Tanda kurang-dari |
| = | Tanda sama dengan |
| - | Tanda minus |
| / | Tanda garis miring |
| ) | Tanda kurung kanan |
| & | Ampersand |
| ~ | Tilde |
| } | Tanda kurung kurawal kanan |
| > | Tanda lebih besar dari |
| Karakter spasi |
Aplikasi global
Fungsi Text ini sadar secara global. Untuk berbagai macam bahasa, fungsi tersebut tahu cara yang tepat untuk menulis tanggal, waktu, mata uang, dan angka. Untuk melakukan pekerjaannya, diperlukan dua bagian informasi:
- Bahasa format kustom: Untuk pembuat, bagaimana format kustom harus ditafsirkan? Karakter pemisah (. dan ,) memiliki arti yang berbeda dalam bahasa yang berbeda. Jika Anda menentukan format kustom, Anda dapat menyertakan placeholder bahasa atau mengambil nilai default, yang mencerminkan bahasa yang diatur dalam perangkat. Bahkan lebih mudah, Anda dapat menggunakan salah satu format tanggal/waktu yang telah ditentukan sebelumnya, yang merupakan agnostik bahasa.
- Bahasa hasil: Untuk pengguna, dalam bahasa apa hasil fungsi harus muncul? Nama bulan dan hari kerja harus dalam bahasa yang sesuai untuk pengguna aplikasi, yang dapat Anda tentukan dengan menambahkan argumen opsional ketiga ke Text fungsi.
Untuk keduanya, tentukan bahasa dengan menggunakan tag bahasa. Untuk melihat daftar bahasa yang didukung, ketik Text( 1234, "", ) di bilah rumus atau tab Tingkat Lanjut dari panel sebelah kanan, lalu gulir daftar lokal yang disarankan untuk argumen ketiga.
Placeholder bahasa
Untuk menentukan bahasa format kustom, gunakan:
| Placeholder | KETERANGAN |
|---|---|
| [$-LanguageTag] | LanguageTag adalah tag bahasa yang dikembalikan dari fungsi Language . Hal ini hanya dapat menentukan bahasa (seperti [$-en] untuk bahasa Inggris), atau juga dapat menentukan kawasan (seperti [$-en-GB] untuk lebih lanjut menentukan Inggris Raya). |
Placeholder bahasa dapat muncul di mana saja dalam format kustom namun hanya sekali.
Jika Anda menentukan format kustom tanpa placeholder bahasa dan formatnya ambigu dari standpoint global, tag bahasa untuk bahasa Anda saat ini disisipkan secara otomatis.
[$-en-US] diasumsikan jika placeholder ini tidak ada saat aplikasi Anda dijalankan.
Catatan
Di versi mendatang, sintaks placeholder ini dapat berubah untuk menghindari kebingungan dengan placeholder yang sama, tetapi berbeda, placeholder yang didukung Excel.
Tag bahasa hasil
Hasilnya Text termasuk string yang diterjemahkan untuk penunjukan bulan, hari kerja, dan AM/PM, serta pemisah grup dan desimal yang sesuai.
Secara default, Text menggunakan bahasa pengguna yang menjalankan aplikasi. Fungsi Language menampilkan tag bahasa untuk pengguna saat ini. Anda dapat mengambil alih nilai default ini dengan menyediakan tag bahasa untuk argumen ketiga ke Text.
Sintaks
Text( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )
- NumberOrDateTime - Wajib. Angka atu nilai tanggal/waktu untuk format.
- DateTimeFormat - Wajib. Anggota enumerasi DateTimeFormat.
- ResultLanguageTag - Opsional. Tag bahasa yang akan digunakan untuk teks hasil. Secara default, bahasa pengguna saat ini digunakan.
Text( NumberOrDateTime, CustomFormat [, ResultLanguageTag ] )
- Nomor - Wajib. Angka atu nilai tanggal/waktu untuk format.
- CustomFormat - Wajib. Satu atau beberapa placeholder yang berada dalam tanda kutip ganda.
- ResultLanguageTag - Opsional. Tag bahasa yang akan digunakan untuk teks hasil. Secara default, bahasa pengguna saat ini digunakan.
Text( AnyValue )
- AnyValue - Wajib. Nilai untuk mengonversi ke representasi teks. Format default digunakan.
Text ( Dinamis )
- Dinamis - Diperlukan. Nilai dinamis yang mewakili string. Nilai yang dapat diterima tergantung pada penyedia tak berjenis. Untuk JSON, jika nilai dinamis adalah angka atau boolean, nilai tersebut akan dikonversi ke teks.
Contoh
Kecuali ditentukan lain, pengguna yang menjalankan rumus ini terletak di Amerika Serikat dan telah memilih bahasa Inggris sebagai bahasa mereka. Fungsi Language menghasilkan "en-US".
Nomor
| Rumus | KETERANGAN | Hasil |
|---|---|---|
| Text( 1234.59, "####.#" ) | Memformat angka dengan satu tempat desimal. | "1234.6" |
| Text( 8.9, "#.000" ) | Mengisi bagian desimal angka dengan diakhiri nol jika diperlukan. | "8.900" |
| Text( 0.631, "0.#" ) | Mengisi bagian keseluruhan angka dengan diawali nol jika diperlukan. | "0.6" |
|
Text( 12, "#.0#" ) Text( 1234.568, "#.0#" ) |
Mengisi bagian desimal angka dengan angka nol untuk satu tempat desimal, dan mencakup tempat desimal kedua jika tersedia. | "12.0" "1234.57" |
|
Text( 12000, "$ #,###" ) Text( 1200000, "$ #,###" ) |
Menempatkan pemisah ribuan setiap tiga digit, dan mencakup simbol mata uang. | "$ 12.000" "$ 1.200.000" |
Tanggal/Waktu
- Pada 2:37:47 PM pada Senin, 23 November, 2015
- Zona Waktu Pasifik Amerika Serikat (UTC-8)
| Rumus | KETERANGAN | Hasil |
|---|---|---|
| Text( Now(), DateTimeFormat.LongDate ) | Memformat sebagai string tanggal panjang, dalam bahasa dan lokal pengguna saat ini. | "Senin, 23 November, 2015" |
| Text( Now(), DateTimeFormat.LongDateTime ) | Memformat sebagai string tanggal dan waktu panjang, dalam bahasa dan lokal pengguna saat ini, menggunakan 12 jam. | "Monday, 23 November, 2015 2:37:47 PM" |
| Text( Now(), DateTimeFormat.LongTime24 ) | Memformat sebagai string waktu panjang, menggunakan 24 jam. | "14:37:47" |
| Text( Now(), DateTimeFormat.ShortDate ) | Memformat sebagai string tanggal singkat, dalam bahasa dan lokal pengguna saat ini. | "11/23/2015" |
| Text( Now(), "d-mmm-yy" ) | Memformat menggunakan karakter placeholder:
|
"23-Nov-15" |
| Text(1448318857*1000, "mmm. dd, yyyy (hh:mm:ss AM/PM)") | Menampilkan nilai tanggal waktu Unix dalam format yang dapat dibaca manusia jika Anda mengalikan nilai sumber sebesar 1.000. | "23 Nov, 2015 (02:47:37 PM)" |
Aplikasi global
| Rumus | KETERANGAN | Hasil |
|---|---|---|
| Text(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") | Menampilkan spasi sebagai pemisah pengelompokan, koma sebagai pemisah desimal, dan € sebagai simbol mata uang. | "1 234 567,89 €" |
| Text(1234567,89; "[$-fr-FR]# ###,## €") | Jika data sumber mengikuti kebiasaan Perancis menggunakan koma sebagai pemisah desimal, Anda harus mengubah lokal Anda menjadi Perancis dan memisahkan argumen dengan tanda baca titik koma dan bukan koma untuk mendapatkan hasil yang sama seperti di atas. | "1 234 567,89 €" |
| Text( Date(2016,1,31), "dddd mmmm d" ) | Menghasilkan hari kerja, bulan, dan hari dalam bulan dalam bahasa pengguna saat ini. Karena tidak ada placeholder yang dependen bahasa, tidak diperlukan tag bahasa teks format. | "Ahad, 31 Januari" |
| Text( Date(2016,1,31), "dddd mmmm d", "es-ES" ) | Menghasilkan hari kerja, bulan, dan hari dalam bulan dalam bahasa "es-ES". | "domingo enero 31" |
Mengonversi nilai ke teks
| Rumus | KETERANGAN | Hasil |
|---|---|---|
| Text( 1234567.89 ) | Mengonversi angka ke string. Tidak ada ribuan pemisah atau kontrol atas jumlah digit sebelum atau setelah pemisah desimal; untuk kontrol lebih banyak, pasok placeholder angka sebagai argumen kedua. | "1234567.89" |
| Text( DateTimeValue( "01/04/2003" ) ) | Mengkonversi nilai tanggal/waktu ke string teks. Untuk mengontrol konversi, berikan salah satu anggota enumerasi atau string kustom-format DateTimeFormat. | "1/4/2003 12:00 AM" |
| Text( benar ) | Mengonversi nilai Boolean menjadi string. | "true" |
| Text(GUID() ) | Mengonversi nilai GUID yang dihasilkan menjadi string. | "f8b10550-0f12-4f08-9aa3-bb10958bc3ff" |
| Kiri( Text( GUID() ), 4 ) | Menampilkan empat karakter pertama dari GUID yang dihasilkan. | "2d9c" |