Kongsi melalui

Fungsi teks

  • Artikel

Digunakan untuk: Apl kanvas Lajur formula apl kanvas Dataverse CLI apl dipacu Power Pages Power Platform model

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)
Tarikh Panjang Empat digit tahun, nama bulan, hari dalam bulan, dan hari dalam minggu. Nama bulan dan hari dalam minggu tidak disingkatkan. "Selasa, 7 April 2020"
Masa Tarikh Panjang 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"
Masa Tarikh Panjang24 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"
Lama Jam (jam 12-jam), minit, saat, dan peruntukan AM/PM. "8:26:59 PM"
Masa Lama24 Jam (jam 24-jam), minit, saat. "20:26:59"
Tarikh Pendek Empat digit tahun dengan bulan berangka dan hari dalam bulan. "4/7/2020"
Masa Tarikh Pendek 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"
Masa Tarikh Pendek24 Empat digit tahun dengan bulan berangka dan hari dalam bulan, serta jam (jam 24-jam) dan minit. "4/7/2020 20:26"
Masa Singkat Jam (jam 12-jam), minit, dan peruntukan AM/PM. "8:26 PM"
Masa Singkat24 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 disertakan dengan 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 dari tengah malam hingga tengah hari dan "PM" atau "p" untuk masa dari 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: Bagi pembuat, bagaimanakah format tersuai harus ditafsirkan? 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 keputusan: Bagi pengguna, dalam bahasa apakah keputusan fungsi harus dipaparkan? 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
[$-Teg Bahasa] LanguageTag ialah tag bahasa seperti 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-AS] diandaikan jika ruang letak ini tidak hadir semasa apl anda dijalankan.

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( Mana-mana Nilai )

  • Mana-mana Nilai - Diperlukan. Nilai untuk ditukarkan ke perwakilan teks. Format lalai digunakan.

Teks ( Tidak ditaip )

  • Tidak ditaip - Diperlukan. objek tanpa jenis yang mewakili rentetan. Nilai yang boleh diterima bergantung pada penyedia tanpa jenis. Untuk JSON, jika objek tanpa jenis ialah 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
Teks( Sekarang(), DateTimeFormat.LongDate ) Format sebagai string tarikh panjang, dalam bahasa dan bahasa pengguna semasa. "Isnin, 23 November, 2015"
Teks( Sekarang(), 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"
Teks( Sekarang(), DateTimeFormat.LongTime24 ) Format sebagai string masa panjang, menggunakan jam 24-jam. "14:37:47"
Teks( Sekarang(), DateTimeFormat.ShortDate ) Format sebagai string tarikh pendek, dalam bahasa dan bahasa pengguna semasa. "23/11/2015"
Teks( Sekarang(), "d-mmm-yy" ) Format menggunakan karakter ruang letak:
  • d untuk hari satu digit atau dua digit dalam sebulan
  • - sebagai aksara literal yang disalin kepada hasil
  • mmm untuk singkatan tiga huruf bulan
  • - sebagai aksara literal lain yang disalin kepada hasil
  • yy untuk singkatan dua digit tahun
 "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 Penerangan Hasil
Teks(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") Menunjukkan ruang sebagai pemisah kumpulan, 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 €"
Teks( Tarikh(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"
Teks( Tarikh(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"