Bagikan melalui

Fungsi Date, DateTime, dan Time

  • Artikel

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

Mengonversi komponen tanggal dan waktu ke nilai tanggal/waktu.

Description

Fungsi Date mengonversi setiap nilai Tahun, Bulan, dan Hari ke nilai Tanggal/Waktu. Bagian waktu tersebut adalah tengah malam.

  • Jika Tahun antara 0 dan 1899 (inklusif), fungsi menambahkan nilai ke 1900 untuk menghitung tahun. 70 menjadi 1970.
  • Jika Bulan kurang dari 1 atau lebih dari 12, hasil akan dikurangi atau ditambahkan beberapa bulan dari awal tahun yang ditentukan.
  • Jika Hari lebih besar dari jumlah hari di bulan yang ditentukan, fungsi tersebut menambahkan beberapa hari ke hari pertama pada bulan tersebut dan menghasilkan tanggal yang sesuai dari bulan berikutnya. Jika Hari kurang dari 1, fungsi mengurangi jumlah hari, plus 1, dari hari pertama bulan yang ditentukan.

Fungsi Time mengonversi nilai Jam, Menit, Detik, dan Milidetik individual menjadi nilai Tanggal/Waktu. Hasil tidak memiliki tanggal yang terkait.

Fungsi DateTime menggabungkan fungsi Tanggal dan Waktu ke dalam satu fungsi, mengambil argumen tanggal dan waktu dan mengembalikan nilai Tanggal /Waktu yang memiliki komponen tanggal dan waktu.

Lihat fungsi DateValue, TimeValue, dan DateTimeValue untuk informasi tentang cara mengonversi string ke nilai.

Juga lihat bekerja dengan tanggal dan waktu untuk informasi lebih lanjut.

Sintaks

Date( Year, Month, Day )

  • Year - Wajib. Angka lebih besar dari 1899 ditafsirkan sebagai mutlak (1980 ditafsirkan sebagai 1980); angka yang berkisar dari 0 hingga 1899 ditafsirkan sebagai relatif terhadap 1900. (Misalnya, 80 ditafsirkan sebagai 1980.)
  • Month - Wajib. Angka yang berkisar dari 1 hingga 12.
  • Day - Wajib. Angka yang berkisar dari 1 hingga 31.

Waktu ( Jam, Menit , Detik [, Milidetik ])

  • Hour - Wajib. Jumlah jam, biasanya dalam rentang 0 (12:00 AM) hingga 23 (11:00 PM).
  • Minute - Wajib. Jumlah menit, biasanya dalam kisaran 0 hingga 59.
  • Second - Wajib. Jumlah detik, biasanya dalam rentang 0 hingga 59.
  • Milidetik - Opsional. Jumlah milidetik, biasanya dalam kisaran 0 hingga 999.

DateTime (Tahun, Bulan, Hari , Jam , Menit, Detik [, Milidetik ])

  • Year - Wajib. Angka lebih besar dari 1899 ditafsirkan sebagai mutlak (1980 ditafsirkan sebagai 1980); angka yang berkisar dari 0 hingga 1899 ditafsirkan sebagai relatif terhadap 1900. (Misalnya, 80 ditafsirkan sebagai 1980.)
  • Month - Wajib. Angka yang berkisar dari 1 hingga 12.
  • Day - Wajib. Angka yang berkisar dari 1 hingga 31.
  • Hour - Wajib. Jumlah jam, biasanya dalam rentang 0 (12:00 AM) hingga 23 (11:00 PM)
  • Minute - Wajib. Jumlah menit, biasanya dalam kisaran 0 hingga 59.
  • Second - Wajib. Jumlah detik, biasanya dalam rentang 0 hingga 59.
  • Milidetik - Opsional. Jumlah milidetik, biasanya dalam kisaran 0 hingga 999.

Contoh

Date

Jika pengguna mengetik

  • 1979 dalam kontrol input teks bernama HireYear
  • 3 dalam kontrol input teks bernama HireMonth
  • 17 dalam kontrol input teks bernama HireDay

Rumus ini akan mengembalikan 3/17/1979:

Date( Value(HireYear.Text), Value(HireMonth.Text), Value(HireDay.Text) )

Waktu

Jika pengguna mengetik

  • 14 dalam kontrol input teks bernama BirthHour
  • 50 dalam kontrol input teks bernama BirthMinute
  • 24 dalam kontrol input teks bernama BirthSecond

Rumus ini akan mengembalikan 02:50:24 P:

Text( 
    Time(Value(BirthHour.Text), Value(BirthMinute.Text), Value(BirthSecond.Text)), 
    "hh:mm:ss A/P" 
)

WaktuTanggal

Jika pengguna mengetik

  • 2023 dalam kontrol input teks bernama EclipseYear
  • 10 dalam kontrol input teks bernama EclipseMonth
  • 28 dalam kontrol input teks bernama EclipseDate
  • 13 dalam kontrol input teks bernama EclipseHour
  • 14 dalam kontrol input teks bernama EclipseMinute
  • 5 dalam kontrol input teks bernama EclipseSecond
  • 231 dalam kontrol input teks bernama EclipseMillisecond

Rumus ini akan mengembalikan 10/28/23 01:14:05.231 PM:

Text(
    DateTime(Value(EclipseYear.Text), Value(EclipseMonth.Text), Value(EclipseDate.Text), 
        Value(EclipseHour.Text), Value(EclipseMinute.Text), 
        Value(EclipseSecond.Text), Value(EclipseSecond.Millisecond)
    ), 
    "yy/mm/dd hh:mm:ss.000 AM/PM"
)