Funkcijas Date, DateTime un Time

  • Raksts

Attiecas uz: Audekla programmām Darbvirsmas plūsmas Modeļa vadītas programmas Power Platform CLI

Konvertē datuma un laika komponentes datuma/laika vērtībā.

Apraksts

Funkcija Date konvertē atsevišķas gada, mēneša un dienas vērtības uz datuma/laika vērtību. Laika daļa ir pusnakts.

  • Ja gada vērtība ir no 0 līdz 1899 (ieskaitot), funkcija pievieno šo vērtību 1900, lai aprēķinātu gadu. 70 kļūst par 1970.
  • Ja mēneša vērtība ir mazāka par 1 vai lielāka par 12, rezultāts atņem vai pievieno tik daudz mēnešus no norādītā gada sākuma.
  • Ja dienas vērtība ir lielāka nekā dienu skaits norādītajā mēnesī, funkcija pieskaita šo dienu skaitu pirmajai mēneša dienai un atgriež atbilstošo datumu no nākamā mēneša. Ja dienas vērtība ir mazāka par 1, funkcija atņem šo dienu skaitu plus 1 no pirmās norādītā mēneša dienas.

Funkcija Time pārvērš atsevišķas vērtības Stunda, Minūte, Sekunde un pēc izvēles Milisekundes par datuma/laika vērtību. Rezultātam nav piesaistīts datums.

Funkcija DateTime apvieno datuma un laika funkcijas vienā funkcijā, ņemot vērā gan datuma, gan laika argumentus un atgriežot datuma/laika vērtību, kurai ir gan datuma, gan laika komponenti.

Lai iegūtu informāciju par to, kā konvertēt virkni vērtībā, skatiet funkcijas DateValue, TimeValue un DateTimeValue.

Skatiet arī darbu ar datumiem un laikiem, lai iegūtu papildinformāciju.

Sintakse

Datums( Gads, Mēnesis, Diena )

  • Gads — Obligāti. Skaitļi, kas ir lielāki par 1899, tiek interpretēti kā absolūti (1980 tiek intepretēts kā 1980), bet skaitļi, kas atrodas diapazonā no 0 līdz 1899, tiek intepretēti kā relatīvi pret 1900. (Piemēram, 80 tiek interpretēts kā 1980.)
  • Mēnesis — Obligāti. Skaitlis diapazonā no 1 līdz 12.
  • Diena — Obligāti. Skaitlis diapazonā no 1 līdz 31.

Laiks( stunda,minūte,sekunde[, milisekundes ])

  • Stunda — Obligāti. Stundu skaits, parasti diapazonā no 0 (12:00 AM) līdz 23 (11:00 PM).
  • Minūte — Obligāti. Minūšu skaits, parasti diapazonā no 0 līdz 59.
  • Sekunde — Obligāti. Sekunžu skaits, parasti diapazonā no 0 līdz 59.
  • Milisekundes - pēc izvēles. Milisekundu skaits, parasti diapazonā no 0 līdz 999.

DateTime(gads,mēnesis,diena,stunda,minūte,sekunde [, milisekundes ])

  • Gads — Obligāti. Skaitļi, kas ir lielāki par 1899, tiek interpretēti kā absolūti (1980 tiek intepretēts kā 1980), bet skaitļi, kas atrodas diapazonā no 0 līdz 1899, tiek intepretēti kā relatīvi pret 1900. (Piemēram, 80 tiek interpretēts kā 1980.)
  • Mēnesis — Obligāti. Skaitlis diapazonā no 1 līdz 12.
  • Diena — Obligāti. Skaitlis diapazonā no 1 līdz 31.
  • Stunda — Obligāti. Stundu skaits, parasti diapazonā no 0 (12:00 AM) līdz 23 (11:00 PM)
  • Minūte — Obligāti. Minūšu skaits, parasti diapazonā no 0 līdz 59.
  • Sekunde — Obligāti. Sekunžu skaits, parasti diapazonā no 0 līdz 59.
  • Milisekundes - pēc izvēles. Milisekundu skaits, parasti diapazonā no 0 līdz 999.

Piemēri

Date

Ja lietotājs ir ierakstījis

  • 1979 . gads teksta ievades vadīklā ar nosaukumu HireYear
  • 3 teksta ievades vadīklā ar nosaukumu HireMonth
  • 17 teksta ievades vadīklā ar nosaukumu HireDay

Šī formula atgrieztos 3/17/1979:

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

Laiks

Ja lietotājs ir ierakstījis

  • 14 teksta ievades vadīklā ar nosaukumu BirthHour
  • 50 teksta ievades vadīklā ar nosaukumu BirthMinute
  • 24 teksta ievades vadīklā ar nosaukumu BirthSecond

Šī formula atgrieztos 02:50:24 P:

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

DateTime

Ja lietotājs ir ierakstījis

  • 2023 . gads teksta ievades vadīklā ar nosaukumu EclipseYear
  • 10 teksta ievades vadīklā ar nosaukumu EclipseMonth
  • 28 teksta ievades vadīklā ar nosaukumu EclipseDate
  • 13 teksta ievades vadīklā ar nosaukumu EclipseHour
  • 14 teksta ievades vadīklā ar nosaukumu EclipseMinute
  • 5 teksta ievades vadīklā ar nosaukumu EclipseSecond
  • 231 teksta ievades vadīklā ar nosaukumu EclipseMillisecond

Šī formula atgrieztos 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"
)