Funktioner for Date, DateTime og Time

  • Artikel

Gælder for: Lærredsapps Skrivebordsflows Modeldrevne apps Power Platform CLI

Konverterer komponenter for dato og klokkeslæt til en værdi for dato og klokkeslæt.

Beskrivelse

Funktionen Date konverterer individuelle værdier for Year, Month og Day til en Date/Time-værdi. Klokkeslætsdelen er midnat.

  • Hvis Year er mellem 0 og 1899 (inklusive), føjer funktionen denne værdi til 1900 for at beregne året. 70 bliver til 1970.
  • Hvis Month er mindre end 1 eller mere end 12, trækker resultatet et tilsvarende antal måneder fra eller lægger dem til begyndelsen af det angivne år.
  • Hvis Day er større end antallet af dage i den angivne måned, føjer funktionen et tilsvarende antal dage til den første dag i måneden og returnerer den tilsvarende dato fra en efterfølgende måned. Hvis Day er mindre end 1, trækker funktionen et tilsvarende antal dage, plus 1, fra den første dag i den angivne måned.

Funktionen Time konverterer de individuelle værdier Hour, Minute, Second og eventuelt Millisecond til en værdi for Date/Time. Resultatet har ikke en dato tilknyttet.

Funktionen DateTime kombinerer funktionerne Date og Time i en enkelt funktion med både dato- og klokkeslætsargumenter og returnerer en Date/Time-værdi, der både indeholder dato- og klokkeslætskomponenter.

Se funktionerne DateValue, TimeValue og DateTimeValue for at få oplysninger om, hvordan du konverterer en streng til en værdi.

Se også Arbejde med datoer og klokkeslæt for at få flere oplysninger.

Syntaks

Date(Year, Month, Day)

  • Year – påkrævet. Tal, der er større end 1899 fortolkes som absolutte (1980 fortolkes som 1980), og tal, der i området 0 til 1899 fortolkes i forhold til 1900. (80 fortolkes f.eks. som 1980).
  • Month – påkrævet. Et tal fra 1 til 12.
  • Day – påkrævet. Et tal fra 1 til 31.

Time( Hour, Minute, Second [, Milliseconds ] )

  • Hour – påkrævet. Antal timer, sædvanligvis i intervallet 0 (12:00 AM) til 23 (11:00 PM).
  • Minute – påkrævet. Antal minutter, normalt i intervallet fra 0 til 59.
  • Second – påkrævet. Antal sekunder, normalt i intervallet fra 0 til 59.
  • Millisekunder - valgfrit. Antal millisekunder, normalt i intervallet fra 0 til 999.

DateTime( År, Måned, Dag, Time, Minut, Sekund [, Millisekunder ] )

  • Year – påkrævet. Tal, der er større end 1899 fortolkes som absolutte (1980 fortolkes som 1980), og tal, der i området 0 til 1899 fortolkes i forhold til 1900. (80 fortolkes f.eks. som 1980).
  • Month – påkrævet. Et tal fra 1 til 12.
  • Day – påkrævet. Et tal fra 1 til 31.
  • Hour – påkrævet. Antal timer, sædvanligvis i intervallet 0 (12:00 AM) til 23 (11:00 PM)
  • Minute – påkrævet. Antal minutter, normalt i intervallet fra 0 til 59.
  • Second – påkrævet. Antal sekunder, normalt i intervallet fra 0 til 59.
  • Millisekunder - valgfrit. Antal millisekunder, normalt i intervallet fra 0 til 999.

Eksempler

Date

Hvis en bruger har indtastet

  • 1979 i et tekstinputkontrolelement, der hedder HireYear
  • 3 i et tekstinputkontrolelement, der hedder HireMonth
  • 17 i et tekstinputkontrolelement, der hedder HireDay

denne formel returnerer 3/17/1979:

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

Tid

Hvis en bruger har indtastet

  • 14 i et tekstinputkontrolelement, der hedder BirthHour
  • 50 i et tekstinputkontrolelement, der hedder BirthMinute
  • 24 i et tekstinputkontrolelement, der hedder BirthSecond

denne formel returnerer 02:50:24 P:

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

Datetime

Hvis en bruger har indtastet

  • 2023 i et tekstinputkontrolelement, der hedder EclipseYear
  • 10 i et tekstinputkontrolelement, der hedder EclipseMonth
  • 28 i et tekstinputkontrolelement, der hedder EclipseDate
  • 13 i et tekstinputkontrolelement, der hedder EclipseHour
  • 14 i et tekstinputkontrolelement, der hedder EclipseMinute
  • 5 i et tekstinputkontrolelement, der hedder EclipseSecond
  • 231 i et tekstinputkontrolelement, der hedder EclipseMillisecond

denne formel returnerer 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"
)