Bagikan melalui


Fungsi DateValue, TimeValue, dan DateTimeValue

Berlaku untuk: Aplikasi kanvas Alur desktop Aplikasi Power Platform berbasis model CLI

Mengonversi tanggal, waktu, atau keduanya dalam string ke nilai tanggal/waktu.

KETERANGAN

  • Fungsi DateValue mengonversi string tanggal (misalnya, "10/01/2014") ke nilai tanggal/waktu.

  • Fungsi TimeValue mengonversi string waktu (misalnya, "12:15 PM") ke nilai tanggal/waktu.

  • Fungsi DateTimeValue mengonversi string tanggal dan waktu (misalnya, "10 Januari 2013 12:13 AM") ke nilai tanggal/waktu.

Fungsi DateValue mengabaikan setiap informasi waktu dalam string tanggal, dan fungsi TimeValue mengabaikan setiap informasi tanggal dalam string waktu.

Catatan

fungsi DateValue, TimeValue, dan DateTimeValue secara default menggunakan bahasa dari pengaturan pengguna saat ini. Anda dapat menimpa untuk memastikan bahwa string ditafsirkan dengan benar. Misalnya, "10/1/1920" ditafsirkan sebagai 1 Oktobera dalam "en" dan 10 Januarib dalam "fr".

Tanggal harus dalam salah satu format berikut:

  • BB/HH/TTTT atau BB-HH-TTTT
  • HH/BB/TTTT atau HH-BB-TTTT
  • TTTT/BB/HH atau TTTT-BB-HH
  • BB/HH/TT atau BB-HH-TT
  • HH/BB/TT atau HH-BB-TT
  • DD Mon YYYY
  • Bulan DD, YYYY

Untuk mengkonversi dari komponen tanggal, bulan, dan tahun numerik, baca Date.
Untuk mengonversi dari komponen jam, menit, dan detik numerik, baca Time.

Untuk informasi lebih lanjut, baca:

Sintaks

DateValue( String [, Language ])
DateTimeValue( String [, Language ])
TimeValue( String [, Language ])

  • String - Wajib. String teks yang berisi tanggal, waktu, atau nilai tanggal dan waktu kombinasi.
  • Language - Opsional. String bahasa, seperti akan dihasilkan oleh dua karakter pertama dari fungsi Language. Jika tidak tersedia, bahasa pengaturan pengguna saat ini digunakan.

DateValue( Tidak Berjenis )
DateTimeValue( Tidak Berjenis )
TimeValue( Tidak Berjenis )

  • Tidak Berjenis - Wajib. Objek tidak berjenis yang menunjukkan tanggal atau waktu. Nilai yang dapat diterima tergantung pada penyedia tak berjenis. Untuk JSON, objek yang tidak berjenis diharapkan adalah string JSON yang berisi tanggal dan waktu dalam format ISO 8601. Tanggal atau waktu dalam format lain akan menghasilkan kesalahan. Pertimbangkan untuk mengkonversi nilai tersebut ke Teks lebih dulu, kemudian ke tanggal atau waktu. Ingat bahwa zona waktu dan format terkait lokal merupakan pertimbangan penting saat berkomunikasi dengan sistem eksternal.

Contoh

DateValue

Jika Anda mengetik 10/11/2014 ke kontrol input teks bernama Startdate, lalu atur properti Teks label ke rumus berikut:

  • Mengkonversi tanggal dari string dalam lokal pengguna dan menampilkan hasil sebagai tanggal panjang.

    Text( DateValue( Startdate.Text ), DateTimeFormat.LongDate )
    

    Perangkat yang diatur ke lokal en menampilkan label sebagai Sabtu, 11 Oktober, 2014.

    Catatan

    Anda dapat menggunakan beberapa opsi dengan enum DateTimeFormat. Untuk menampilkan daftar opsi, ketik parameter yang diikuti dengan tanda titik (.) di bilah rumus atau periksa referensi fungsi Text.

  • Mengkonversi tanggal dari string dalam lokal Perancis dan menampilkan hasil sebagai tanggal panjang. Dalam contoh ini, bulan dan hari pada bulan tersebut ditafsirkan berbeda dari bahasa Inggris.

    Text( DateValue( Startdate.Text, "fr" ), DateTimeFormat.LongDate )
    

    Perangkat yang diatur ke lokal en menampilkan label sebagai Senin, 10 November, 2014.

Jika Anda mengetik 20 Oktober 2014 sebagai gantinya:

  • Mengonversi tanggal dari string dalam lokal pengguna dan menghitung selisih antara dua hari, dalam hari

    DateDiff( DateValue( Startdate.Text ), Today() )
    

    Perangkat yang diatur ke lokal en menampilkan label 9, menunjukkan jumlah hari antara 11 Oktober dan 20 Oktober. Fungsi DateDiff juga dapat menunjukkan perbedaan dalam bulan, kuartal, atau tahun.

DateTimeValue

Jika Anda mengetik 10/11/2014 1:50:24.765 PM ke kontrol input teks bernama Mulai, dan kemudian menetapkan properti Teks label dengan rumus berikut:

  • Mengonversi string tanggal dan waktu dalam lokal saat ini.

    Text( DateTimeValue( Start.Text ), DateTimeFormat.LongDateTime )
    

    Perangkat diatur ke lokal en menunjukkan label sebagai Sabtu, 11 Oktober, 2014 1:50:24 PM.

    Catatan

    Anda dapat menggunakan beberapa opsi dengan enum DateTimeFormat. Untuk menampilkan daftar opsi, ketik parameter yang diikuti dengan tanda titik (.) di bilah rumus atau periksa referensi fungsi Text.

  • Mengkonversi string tanggal dan waktu di lokal Prancis. Bulan dan hari pada bulan tersebut ditafsirkan berbeda.

    Text( DateTimeValue( Start.Text, "fr"), DateTimeFormat.LongDateTime )
    

    Perangkat yang diatur ke lokal en menampilkan label sebagai Senin, 10 November 2014 1:50:24 PM.

  • Mengkonversi string tanggal dan waktu di lokal pengguna, dan menampilkan hasil dengan detik fraksional.

    Text( DateTimeValue( Start.Text ), "dddd, mmmm dd, yyyy hh:mm:ss.fff AM/PM" )
    

    Perangkat diatur ke lokal en menunjukkan label sebagai Sabtu, 11 Oktober, 2014 01:50:24.765 PM.

    Sebagai alternatif, Anda dapat menentukan hh:mm:ss.f atau hh:mm:ss.ff untuk membulatkan waktu hingga satu per 10a atau satu per 100b detik.

TimeValue

Namai kontrol input teks FinishedAt, dan atur properti Teks label ke rumus ini:

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)
  • Jika Anda mengetik 4:59:59.999 PM dalam kontrol FinishedAt, label akan menampilkan "Anda berhasil!"
  • Jika Anda mengetik 5:00:00.000 PM dalam kontrol FinishedAt, label menampilkan "Terlalu terlambat!"