Fungsi teks
Berlaku untuk:
Aplikasi kanvas Aplikasi kanvas kolom rumus Aplikasi Dataverse Power Platform berbasis model CLI
Mengubah semua nilai dan memformat angka atau nilai tanggal/waktu menjadi string teks.
KETERANGAN
Fungsi Text memformat angka atau nilai tanggal/waktu berdasarkan salah satu jenis argumen berikut:
- 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 Text juga dapat mengkonversi jenis data ke 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) |
|---|---|---|
| LongDate | Empat digit tahun, nama bulan, hari dalam sebulan, dan hari dalam seminggu. Nama bulan dan hari dalam seminggu tidak disingkat. | "Tuesday, April 7, 2020" |
| LongDateTime | 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. | "Tuesday, April 7, 2020 8:26:59 PM" |
| LongDateTime24 | 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. | "Tuesday, April 7, 2020 20:26:59" |
| LongTime | Jam (12 jam), menit, detik, dan penyebutan PM/PM. | "8:26:59 PM" |
| LongTime24 | Jam (24 jam), menit, detik. | "20:26:59" |
| ShortDate | Empat digit tahun dengan bulan numerik dan hari dalam sebulan. | "4/7/2020" |
| ShortDateTime | Empat digit tahun dengan bulan numerik dan hari dalam sebulan, plus jam (12 jam), menit dan penyebutan AM/PM. | "4/7/2020 8:26 PM" |
| ShortDateTime24 | Empat digit tahun dengan bulan numerik dan hari dalam sebulan, plus jam (24 jam) dan menit. | "4/7/2020 20:26" |
| ShortTime | Jam (12 jam), menit, dan penyebutan PM/PM. | "8:26 PM" |
| ShortTime24 | 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, Teks tidak menghasilkan nol ekstra saat angka memiliki digit yang lebih sedikit di kedua 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. Teks memisahkan grup dengan koma jika format berisi koma yang diapit dengan 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. Placeholder ini harus muncul segera setelah h atau kode hh atau segera sebelum kode ss; jika tidak, Teks akan menghasilkan bulan, bukan 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, Teks akan menghasilkan bulan, bukan 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. Teks menampilkan "AM" atau "a" selama beberapa waktu dari tengah malam hingga tengah hari dan "PM" atau "p" untuk waktu dari siang hingga tengah malam |
Placeholder literal
Anda dapat menyertakan salah satu karakter ini dalam string format. Karakter tersebut akan muncul dalam hasil Teks sebagaimana 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 tersedia 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 akan 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 fungsi Text.
Untuk keduanya, tentukan bahasa dengan menggunakan tag bahasa. Untuk melihat daftar bahasa yang didukung, ketik Text( 1234, "", ) di bilah formula atau tab Lanjutan di panel 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 dihasilkan 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 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
Hasil Teks mencakup string yang diterjemahkan selama berbulan-bulan, hari kerja, dan sebutan AM/PM, serta grup yang sesuai dan pemisah desimal.
Secara default, Teks menggunakan bahasa pengguna yang menjalankan aplikasi. Fungsi Language menampilkan tag bahasa untuk pengguna saat ini. Anda dapat menimpa nilai default ini dengan menyediakan tag bahasa untuk argumen ketiga ke Teks.
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 ] )
- Number - 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 ( Tidak Berjenis )
- Tidak Berjenis - Wajib. Objek tidak berjenis yang menunjukkan string. Nilai yang dapat diterima tergantung pada penyedia tak berjenis. Untuk JSON, jika objek yang tidak diketik adalah angka atau boolean, objek tersebut akan dikonversi menjadi 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 | Description | 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( true ) | Mengonversi nilai Boolean menjadi string. | "true" |
| Text( GUID() ) | Mengonversi nilai GUID yang dihasilkan menjadi string. | "f8b10550-0f12-4f08-9aa3-bb10958bc3ff" |
| Left( Text( GUID() ), 4 ) | Menampilkan empat karakter pertama dari GUID yang dihasilkan. | "2d9c" |