Fungsi teks
Digunakan untuk:
Aplikasi kanvas Templat formula lajur Dataverse aplikasi berpandukan Power Pages Power Platform model CLI
Menukar sebarang nilai dan format nombor atau nilai tarikh/masa ke string teks.
Penerangan
Fungsi Text memformat nombor atau nilai tarikh/masa berasaskan pada salah satu jenis argumen ini:
- Format pratakrif bagi tarikh/masa, yang anda tentukan dengan menggunakan penghitungan DateTimeFormat. Untuk tarikh dan masa, pendekatan ini diutamakan kerana ia dilaras secara automatik ke bahasa dan rantau setiap pengguna.
- Format tersuai, mengandungi string ruang letak yang menakrifkan, contohnya, sama ada nombor menunjukkan pemisah perpuluhan dan tarikh menunjukkan nama penuh bulan, bulan sebagai singkatan, atau bulan sebagai nombor. Power Apps menyokong subset ruang letak yang dilakukan oleh Microsoft Excel. Dalam string ini, ruang letak bahasa menentukan bahasa ruang letak lain yang akan diterjemah. Jika format tersuai termasuk tempoh, ruang letak format bahasa menentukan sama ada tempoh ialah pemisah perpuluhan (ja-JP) atau pemisah ribuan (es-ES).
Lihat kerja dengan tarikh dan masa untuk maklumat lanjut.
Fungsi Text juga boleh menukar sebarang jenis data ke perwakilan teks menggunakan format lalai. Gunakan ini untuk meluluskan nilai bukan teks ke fungsi berasaskan teks seperti Len, Right, dan IsMatch.
Format pratakrif tarikh/masa
Untuk contoh ini, tarikh dan masa yang digunakan ialah Selasa, 7 April 2020 8:26:59.180 PM, dalam zon waktu UTC-7 jam.
| DateTimeFormat enum | Penerangan | Contoh (menggunakan en-US) |
|---|---|---|
| LongDate | Empat digit tahun, nama bulan, hari dalam bulan, dan hari dalam minggu. Nama bulan dan hari dalam minggu tidak disingkatkan. | "Selasa, 7 April 2020" |
| LongDateTime | Empat digit tahun, nama bulan, hari dalam bulan, dan hari dalam minggu, serta jam (jam 12-jam), minit, saat, dan peruntukan AM/PM. Nama bulan dan hari dalam minggu tidak disingkatkan. | "Selasa, 7 April 2020 8:26:59 PM" |
| LongDateTime24 | Empat digit tahun, bulan, hari dalam bulan, dan hari dalam minggu, serta jam (jam 24-jam), minit, dan saat.. Nama bulan dan hari dalam minggu tidak disingkatkan. | "Selasa, 7 April 2020 20:26:59" |
| LongTime | Jam (jam 12-jam), minit, saat, dan peruntukan AM/PM. | "8:26:59 PM" |
| LongTime24 | Jam (jam 24-jam), minit, saat. | "20:26:59" |
| ShortDate | Empat digit tahun dengan bulan berangka dan hari dalam bulan. | "4/7/2020" |
| ShortDateTime | Empat digit tahun dengan bulan berangka dan hari dalam bulan, serta jam (jam 12-jam), minit, dan peruntukan AM/PM. | "4/7/2020 8:26 PM" |
| ShortDateTime24 | Empat digit tahun dengan bulan berangka dan hari dalam bulan, serta jam (jam 24-jam) dan minit. | "4/7/2020 20:26" |
| ShortTime | Jam (jam 12-jam), minit, dan peruntukan AM/PM. | "8:26 PM" |
| ShortTime24 | Jam (jam 24-jam) dan minit. | "20:26" |
| UTC | Nilai tarikh/masa ditukar ke UTC berasaskan pada zon masa semasa pengguna dan diformat mengikut standard ISO 8601. | "2020-04-08T03:26:59.180Z" |
Ruang letak nombor
| Ruang Letak | Penerangan |
|---|---|
| 0 (Sifar) | Memaparkan sifar jika nombor mempunyai kurang digit berbanding sifar dalam format. Contohnya, menggunakan format #.00 jika anda mahu memaparkan 8.9 sebagai 8.90. |
| # | Ikuti peraturan yang sama seperti 0 (sifar). Walau bagaimanapun, Teks tidak mengembalikan tambahan sifar apabila nombor mempunyai kurang digit pada mana-mana bahagian perpuluhan berbanding simbol # dalam format. Contohnya, 8.9 dipaparkan jika format tersuai ialah #.## dan nombor untuk diformat ialah 8.9. |
| . (tempoh) | Paparkan titik perpuluhan dalam nombor. Bergantung kepada bahasa format tersuai; lihat aplikasi global untuk butiran lanjut. |
| , (koma) | Memaparkan himpunan pemisah dalam nombor, selalu digunakan untuk ribuan. Teks memisahkan kumpulan dengan koma jika format mengandungi koma yang dilampirkan oleh tanda nombor (#) atau dengan sifar. Bergantung kepada bahasa format tersuai; lihat aplikasi global untuk butiran lanjut. |
Jika nombor mempunyai lebih digit di kanan titik perpuluhan berbanding ruang letak dalam format, nombor bulat di seberapa banyak tempat titik perpuluhan sebagai ruang letak. Jika terdapat lebih digit di sebelah kiri berbanding ruang letak, tambahan digit dipaparkan. Jika format mengandungi hanya tanda nombor (#) di kiri titik perpuluhan, nombor yang kurang daripada 1 bermula dengan titik perpuluhan (contoh, .47).
Tarikh dan masa ruang letak
| Ruang Letak | Penerangan |
|---|---|
| m | Paparkan bulan sebagai nombor tanpa sifar di hadapan. |
| mm | Memaparkan bulan sebagai nombor dengan sifar di hadapan mengikut kesesuaian. |
| mmm | Memaparkan bulan sebagai singkatan (Jan ke Dis). |
| mmmm | Memaparkan bulan sebagai nama penuh (Januari ke Disember). |
| d | Memaparkan hari sebagai nombor tanpa sifat di hadapan. |
| dd | Memaparkan hari sebagai nombor dengan sifat di hadapan mengikut kesesuaian. |
| ddd | Memaparkan hari sebagai singkatan (Aha ke Sab). |
| dddd | Memaparkan hari sebagai nama penuh (Ahad ke Sabtu). |
| yy | Memaparkan tahun sebagai nombor dua digit. |
| yyyy | Memaparkan tahun sebagai nombor empat digit. |
| h | Memaparkan jam sebagai nombor tanpa sifat di hadapan. |
| hh | Memaparkan jam sebagai nombor tanpa sifar di hadapan mengikut kesesuaian. Jika format mengandungi AM atau PM, jam ditunjukkan berasaskan jam 12-jam. Jika tidak, jam ditunjukkan berasaskan pada jam 24-jam. |
| m | Memaparkan minit sebagai nombor tanpa sifar di hadapan. Ruang letak mesti dipaparkan segera selepas kod h atau hh atau dengan segera sebelum kod ss; jika tidak, Teks mengembalikan bulan berbanding minit. |
| mm | Memaparkan minit sebagai nombor dengan sifar di hadapan mengikut kesesuaian. Ruang letak mesti dipaparkan segera selepas ruang letak h atau hh atau dengan segera sebelum ruang letak ss. Jika tidak, Teks mengembalikan bulan berbanding minit. |
| s | Memaparkan saat sebagai nombor tanpa sifar di hadapan. |
| ss | Memaparkan saat sebagai nombor dengan sifar di hadapan mengikut kesesuaian. |
| f | Memaparkan pecahan saat. |
| AM/PM, a/p | Memaparkan jam berasaskan jam 12-jam. Teks mengembalikan "AM" atau "a" untuk masa daripada tengah malam hingga tengah hari dan "PM" atau "p" untuk masa daripada tengah hari hingga tengah malam |
Ruang letak literal
Anda boleh memasukkan mana-mana karakter ini dalam string format anda. Ia akan dipaparkan dalam hasil Teks. Karakter tambahan diperuntukkan untuk ruang letak akan datang, oleh itu anda hendaklah tidak menggunakannya.
| Karakter | Penerangan |
|---|---|
| Mana-mana simbol mata wang | Tanda dolar, tanda sen, tanda euro, dll. |
| + | Tanda tambah |
| ( | Parentesis kiri |
| : | Kolon |
| ^ | Circumflex accent (caret) |
| ' | Koma atas |
| { | Tanda kurungan ikal |
| < | Tanda kurang daripada |
| = | Tanda sama |
| - | Tanda tolak |
| / | Tanda miring |
| ) | Parentesis kanan |
| & | Ampersan |
| ~ | Tilde |
| } | Kurungan ikal kanan |
| > | Tanda lebih besar daripada |
| Karakter ruang |
Aplikasi global
Fungsi Text adalah diketahui secara global. Untuk tatasusunan bahasa yang luas, ia mengetahui bagaimana menulis tarikh, masa, mata wang, dan nombor dengan betul. Untuk melakukan tugasnya, ia memerlukan dua maklumat:
- Bahasa format tersuai: Untuk pembuat, bagaimana hendak menterjemahkan format tersuai? Karakter pemisah (. dan ,) mempunyai makna berbeza dalam bahasa yang berbeza. Jika anda menentukan format tersuai, anda boleh memasukkan ruang letak bahasa atau mengambil nilai lalai, yang menunjukkan bahasa yang ditetapkan untuk peranti anda. Lebih mudah lagi, anda boleh menggunakan salah satu format tarikh/masa pratakrif, yang agnostik bahasa.
- Bahasa hasil: Untuk pengguna, hasil fungsi dipaparkan dalam apa bahasa? Nama bulan dan hari kerja mesti dalam bahasa yang bersesuaian untuk pengguna aplikasi, yang anda boleh tentukan dengan menambah argumen pilihan, ketiga ke fungsi Text.
Untuk kedua-duanya, anda boleh tentukan bahasa menggunakan tag bahasa. Untuk melihat senarai bahasa yang disokong, taip Teks( 1234, "", ) dalam formula bar atau tab Lanjutan anak tetingkap sebelah kanan, dan kemudian tatal melalui senarai bahasa yang dicadangkan untuk argumen ketiga.
Ruang letak bahasa
Untuk menentukan bahasa untuk format tersuai, gunakan:
| Ruang Letak | Penerangan |
|---|---|
| [$-LanguageTag] | LanguageTag ialah tag bahasa yang dikembalikan daripada fungsi Bahasa. Anda boleh menentukan hanya bahasa (seperti [$-en] untuk Bahasa Inggeris), atau ia juga boleh menentukan rantau (seperti [$-en-GB] untuk menentukan secara lanjut Great Britain). |
Ruang letak bahasa boleh dipaparkan di mana-mana dalam format tersuai tetapi hanya sekali sahaja.
Jika anda menentukan format tersuai tanpa ruang letak bahasa dan format adalah tidak jelas daripada perspektif global, tag bahasa untuk bahasa semasa anda akan dimasukkan secara automatik.
[$-en-US] diandaikan jika ruang letak tidak wujud semasa aplikasi anda berjalan.
Nota
Dalam versi akan datang, sintaks ruang letak mungkin berubah untuk mengelakkan kekeliruan dengan ruang letak yang disokong oleh Excel, serupa, tetapi berbeza.
Tag bahasa hasil
Hasil Teks termasuk string yang diterjemah untuk bulan, hari kerja, dan peruntukan AM/PM, serta kumpulan yang bersesuaian dan pemisah perpuluhan.
Secara lalai, Teks menggunakan bahasa yang pengguna gunakan untuk menjalankan aplikasi. Fungsi Language mengembalikan tag bahasa untuk pengguna semasa. Anda boleh menggantikan nilai lalai dengan membekalkan tag bahasa untuk argumen ketiga ke Teks.
Sintaks
Teks( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )
- NumberOrDateTime - Diperlukan. Bilangan nilai tarikh/masa untuk diformat.
- DateTimeFormat - Diperlukan. Ahli penghitungan DateTimeFormat.
- ResultLanguageTag - Pilihan Tag bahasa untuk digunakan bagi teks hasil. Secara lalai, bahasa untuk pengguna semasa digunakan.
Teks( NumberOrDateTime, CustomFormat [, ResultLanguageTag ] )
- Nombor - Diperlukan. Bilangan nilai tarikh/masa untuk diformat.
- CustomFormat - Diperlukan. Satu atau lebih ruang letak dilampirkan dalam tanda petikan berganda.
- ResultLanguageTag - Pilihan Tag bahasa untuk digunakan bagi teks hasil. Secara lalai, bahasa untuk pengguna semasa digunakan.
Teks( AnyValue )
- AnyValue - Diperlukan. Nilai untuk ditukarkan ke perwakilan teks. Format lalai digunakan.
Teks ( Tanpa jenis )
- Untyped - Diperlukan. Objek tanpa jenis yang mewakili rentetan. Nilai yang boleh diterima bergantung pada penyedia tanpa jenis. Untuk JSON, jika objek tanpa jenis adalah nombor atau boolean, ia akan ditukar kepada teks.
Contoh
Melainkan ditentukan sebaliknya, pengguna yang menjalankan formula ini terletak di Amerika syarikat dan telah memilih Bahasa Inggeris sebagai bahasa mereka. Fungsi Language mengembalikan "en-US".
Nombor
| Formula | Penerangan | Hasil |
|---|---|---|
| Teks( 1234.59, "####.#" ) | Format nombor dengan satu tempat perpuluhan. | "1234.6" |
| Teks( 8.9, "#.000" ) | Penuhkan bahagian perpuluhan nombor dengan sifar di belakang, jika diperlukan. | "8.900" |
| Teks( 0.631, "0.#" ) | Penuhkan keseluruhan bahagian nombor dengan sifar di hadapan, jika diperlukan. | "0.6" |
|
Teks( 12, "#.0#" ) Teks( 1234.568, "#.0#" ) |
Penuhkan bahagian perpuluhan nombor dengan sifar untuk satu tempat perpuluhan, dan masukkan tempat perpuluhan kedua jika diberikan. | "12.0" "1234.57" |
|
Teks( 12000, "$ #,###" ) Teks( 1200000, "$ #,###" ) |
Tempatkan pemisah ribuan setiap tiga digit, dan masukkan simbol mata wang. | "$ 12,000" "$ 1,200,000" |
Tarikh/Masa
- Pada 2:37:47 PM pada Isnin, 23 November, 2015
- Zon Masa Pasifik Amerika Syarikat (UTC-8)
| Formula | Penerangan | Hasil |
|---|---|---|
| Text( Now(), DateTimeFormat.LongDate ) | Format sebagai string tarikh panjang, dalam bahasa dan bahasa pengguna semasa. | "Isnin, 23 November, 2015" |
| Text( Now(), DateTimeFormat.LongDateTime ) | Format sebagai string tarikh panjang, dalam bahasa dan bahasa pengguna semasa, menggunakan jam 12-jam. | "Isnin, 23 November, 2015 2:37:47 PM" |
| Text( Now(), DateTimeFormat.LongTime24 ) | Format sebagai string masa panjang, menggunakan jam 24-jam. | "14:37:47" |
| Text( Now(), DateTimeFormat.ShortDate ) | Format sebagai string tarikh pendek, dalam bahasa dan bahasa pengguna semasa. | "23/11/2015" |
| Text( Now(), "d-mmm-yy" ) | Format menggunakan karakter ruang letak:
|
"23-Nov-15" |
| Teks(1448318857*1000, "mmm. dd, yyyy (hh:mm:ss AM/PM)") | Menunjukkan nilai tarikh/masa Unix dalam format boleh dibaca oleh manusia jika anda darabkan nilai sumber dengan 1,000. | "Nov. 23, 2015 (02:47:37 PM)" |
Aplikasi global
| Formula | Description | Keputusan |
|---|---|---|
| Teks(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") | Menunjukkan ruang sebagai pemisah pengumpulan, koma sebagai pemisah perpuluhan dan € sebagai simbol mata wang. | "1 234 567,89 €" |
| Teks(1234567,89; "[$-fr-FR]# ###,## €") | Jika data sumber mengikut tradisi Bahasa Perancis menggunakan koma sebagai pemisah perpuluhan, anda mesti mengubah bahasa anda ke Bahasa Perancis dan memisahkan argumen dengan koma bernoktah berbanding koma untuk mendapatkan hasil yang sama seperti di atas. | "1 234 567,89 €" |
| Text( Date(2016,1,31), "dddd mmmm d" ) | Mengembalikan hari kerja, bulan, dan hari dalam bulan dalam bahasa semasa pengguna. Oleh kerana ruang letak bukan bahasa bergantung, tiada keperluan untuk memformat teks tag bahasa. | "Ahad 31 Januari" |
| Text( Date(2016,1,31), "dddd mmmm d", "es-ES" ) | Mengembalikan hari kerja, bulan, dan hari dalam bulan dalam bahasa "es-ES". | "domingo enero 31" |
Menukar nilai ke teks
| Formula | Penerangan | Hasil |
|---|---|---|
| Teks( 1234567.89 ) | Menukar nombor ke string. Tiada pemisah ribuan atau kawalan ke atas bilangan nombor digit sebelum atau selepas pemisah perpuluhan; untuk kawalan lebih, berikan nombor ruang letak sebagai argumen kedua.. | "1234567.89" |
| Teks( DateTimeValue( "01/04/2003" ) ) | Menukar nilai tarikh/masa ke string teks. Untuk mengawal pertukaran, sediakan ahli penghitungan DateTimeFormat atau string format tersuai. | "1/4/2003 12:00 AM" |
| Teks( benar ) | Tukarkan nilai Boolean ke string. | "benar" |
| Teks( GUID() ) | Tukarkan nilai GUID dijana ke string. | "f8b10550-0f12-4f08-9aa3-bb10958bc3ff" |
| Kiri( Teks( GUID() ), 4 ) | Mengembalikan empat karakter pertama untuk GUID dijana. | "2d9c" |
Maklum balas
Akan datang: Sepanjang 2024, kami akan menghentikan secara berperingkat Isu GitHub sebagai kaedah maklum balas untuk kandungan dan menggantikannya dengan sistem maklum balas baharu. Untuk mendapatkan maklumat lanjut lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat maklum balas untuk