Fungsi DateValue, TimeValue dan DateTimeValue

Artikel
06/10/2024

Digunakan untuk: Aplikasi kanvas Desktop mengalir aplikasi Power Pages Power Platform berpandukan model CLI

Menukarkan nilai tarikh, masa atau kedua-dua dalam rentetan kepada tarikh/masa.

Penerangan

Fungsi DateValue menukarkan rentetan tarikh (contohnya, "10/01/2014") kepada nilai tarikh/masa.
Fungsi TimeValue menukarkan rentetan masa (sebagai contoh, "12:15 PTG") kepada nilai tarikh/masa.
Fungsi DateTimeValue menukarkan rentetan tarikh dan masa (sebagai contoh, "10 Januari 2013 12:13 PG") kepada nilai tarikh/masa.

Fungsi DateValue mengabaikan sebarang maklumat masa dalam rentetan tarikh dan fungsi TimeValue mengabaikan sebarang maklumat tarikh dalam rentetan masa.

Nota

Fungsi DateValue, TimeValue dan DateTimeValue secara lalai menggunakan bahasa dari tetapan pengguna semasa. Anda boleh mengatasi untuk memastikan rentetan diterjemahkan dengan betul. Sebagai contoh, "10/1/1920" adalah diterjemahkan sebagai Oktober 1^st dalam "en" dan sebagai Januari 10^th dalam "fr".

Tarikh mestilah berada dalam salah satu format berikut:

HH/BB/TTTT atau HH-BB-TTTT
HH/BB/TTTT atau HH-BB-TTTT
HH/BB/TTTT atau HH-BB-TTTT
HH/BB/TT or HH-BB-TT
HH/BB/TT or HH-BB-TT
HH Bul TTTT
Bulan HH, TTTT

Untuk menukarkan dari komponen tarikh angka, bulan dan tahun, baca Date.
Untuk menukarkan dari komponen jam angka, minit dan saat, baca Time.

Untuk maklumat lanjut, baca:.

Sintaks

DateValue( Rentetan [, Bahasa ])
DateTimeValue( Rentetan [, Bahasa ])
TimeValue( Rentetan [, Bahasa ])

Rentetan - Diperlukan. Rentetan teks yang mengandungi tarikh, masa atau nilai gabungan tarikh dan masa.
Bahasa - Pilihan. Rentetan bahasa seperti yang akan dikembalikan oleh aksara terlebih dahulu dari fungsi Language. Jika tidak diberikan, bahasa untuk tetapan pengguna semasa sedang digunakan.

DateValue( Untyped )
DateTimeValue( Untyped )
TimeValue( Untyped )

Untyped - Diperlukan. Objek Untyped yang mewakili tarikh atau masa. Nilai yang boleh diterima bergantung pada penyedia tanpa jenis. Untuk JSON, objek untyped dijangka adalah rentetan JSON yang mengandungi tarikh dan masa dalam format ISO 8601. Tarikh atau masa dalam format lain akan menghasilkan ralat. Pertimbangkan untuk menukar nilai tersebut kepada Text terlebih dahulu, kemudian kepada tarikh atau masa. Perlu diingat bahawa zon waktu dan format berkaitan tempat adalah pertimbangan penting semasa berkomunikasi dengan sistem luaran.

Contoh

DateValue

Jika anda menaip 10/11/2014 ke dalam kawalan input teks bernama Startdate dan kemudian menetapkan sifat Teks label kepada formula ini.

Tukarkan tarikh daripada rentetan dalam lokasi pengguna dan tunjukkan hasil sebagai tarikh panjang.
```
Text( DateValue( Startdate.Text ), DateTimeFormat.LongDate )
```
Peranti ditetapkan kepada en tempatan menunjukkan label sebagai Sabtu, 11 Oktober 2014.

Nota

Anda boleh menggunakan beberapa pilihan dengan hitung DateTimeFormat. Untuk memaparkan senarai pilihan, taipkan parameter diikuti dengan titik atau tempoh (.) dalam bar formula atau semak Text function reference.
Tukarkan tarikh daripada rentetan dalam lokasi Perancis dan tunjukkan hasil sebagai tarikh panjang. Dalam contoh ini, bulan dan hari bulan diterjemahkan secara berbeza daripada bahasa Inggeris.
```
Text( DateValue( Startdate.Text, "fr" ), DateTimeFormat.LongDate )
```
Peranti ditetapkan kepada en tempatan menunjukkan label sebagai Isnin, 10 November 2014.

Jika anda menaip 20 Oktober 2014 sebaliknya:

Tukarkan tarikh daripada rentetan dalam lokasi pengguna dan kira perbezaan antara dua hari dalam beberapa hari
```
DateDiff( DateValue( Startdate.Text ), Today() )
```
Peranti ditetapkan kepada en tempatan yang menunjukkan label itu sebagai 9, menunjukkan bilangan hari antara 11 Oktober dan 20 Oktober. Fungsi DateDiff juga boleh menunjukkan perbezaan dalam bulan, suku atau tahun.

DateTimeValue

Jika anda menaip 10/11/2014 1:50:24.765 PTG ke dalam kawalan input teks bernama Mula dan kemudian menetapkan sifat Teks label kepada formula berikut:

Tukarkan rentetan tarikh dan masa dalam tempat semasa.
```
Text( DateTimeValue( Start.Text ), DateTimeFormat.LongDateTime )
```
Peranti ditetapkan kepada en tempatan menunjukkan label sebagai Sabtu, 11 Oktober 2014 1:50:24 PTG.

Nota

Anda boleh menggunakan beberapa pilihan dengan hitung DateTimeFormat. Untuk memaparkan senarai pilihan, taipkan parameter diikuti dengan titik atau tempoh (.) dalam bar formula atau semak Text function reference.
Tukarkan rentetan tarikh dan masa dalam bahasa Perancis tempatan. Bulan dan hari bulan diterjemahkan secara berbeza.
```
Text( DateTimeValue( Start.Text, "fr"), DateTimeFormat.LongDateTime )
```
Peranti ditetapkan kepada en tempatan menunjukkan label sebagai Isnin, 10 November 2014 1:50:24 PTG.
Tukarkan kedua-dua rentetan tarikh dan masa dalam lokasi pengguna dan memaparkan hasil dengan pecahan saat.
```
Text( DateTimeValue( Start.Text ), "dddd, mmmm dd, yyyy hh:mm:ss.fff AM/PM" )
```
Peranti ditetapkan kepada en tempatan menunjukkan label sebagai Sabtu, 11 Oktober 2014 01:50:24.765 PTG.

Sebagai alternatif, anda boleh menentukan hh:mm:ss.f atau hh:mm:ss.ff untuk membundarkan masa yang terdekat 10^th atau 100^th bagi saat.

TimeValue

Namakan kawalan input teks FinishedAt dan tetapkan sifat Teks label kepada formula ini:

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)

Jika anda menaip 4:59:59.999 PTG dalam kawalan FinishedAt, label menunjukkan "Anda berjaya!"
Jika anda menaip 5:00:00.000 PTG dalam kawalan FinishedAt, label menunjukkan "Terlambat!"

Kongsi melalui