Funktionerna Date, DateTime och Time

  • Artikel

Gäller: Arbetsyteappar Datorflöden Modellbaserade appar Power Platform CLI

Konverterar datum- och tidkomponenter till ett Date/Time-värde.

Beskrivning

Date-funktionen konverterar enskilda värden för Year, Month och Day till ett Date/Time-värde. Tidsdelen är midnatt.

  • Om året är mellan 0 och 1899 (inklusive), lägger funktionen till detta värde till 1900 för att beräkna året. 70 blir 1970.
  • Om Month är mindre än 1 eller mer än 12 subtraherar eller lägger resultatet till så många månader från början av det angivna året.
  • Om Day är större än antalet dagar i den angivna månaden lägger funktionen till detta antal dagar till den första dagen i månaden och returnerar motsvarande datum från en efterföljande månad. Om Day är mindre än 1 subtraherar funktionen så många dagar, plus 1, från den första dagen i den angivna månaden.

Funktionen Time konverterar enskilda tim-, minut-, sekund- och valfritt millisekundvärden till ett datum/tid-värde. Resultatet har inget datum kopplat till det.

Med funktionen DateTime kombineras funktionerna Date och Time till en enda funktion som tar både datum- och tidsargument och returnerar ett datum/tid-värde som har både datum- och tidskomponenter.

Se funktionerna DateValue, TimeValue och DateTimeValue för information om hur en sträng konverteras till ett värde.

Mer information finns även i Arbeta med datum och tid.

Syntax

Date( Year, Month, Day )

  • Year – obligatoriskt. Tal som är större än 1899 tolkas som absoluta (1980 tolkas som 1980), tal mellan 0 och 1899 tolkas i förhållande till 1900. (80 tolkas till exempel som 1980.)
  • Month – obligatoriskt. Ett tal mellan 1 och 12.
  • Day – obligatoriskt. Ett tal mellan 1 och 31.

Tid( Timme, Minut, Sekund [, Millisekund ] )

  • Hour – obligatoriskt. Antal timmar, vanligtvis i intervallet 0 (00:00) till 23 (23:00).
  • Minute – obligatoriskt. Antal minuter, vanligtvis i intervallet 0 till 59.
  • Second – obligatoriskt. Antal sekunder, vanligtvis i intervallet 0 till 59.
  • Millisekunder – valfritt. Antal millisekunder, vanligtvis i intervallet 0 till 999.

DateTime( år, månad, dag, timme, minut, sekund [, millisekunder ] )

  • Year – obligatoriskt. Tal som är större än 1899 tolkas som absoluta (1980 tolkas som 1980), tal mellan 0 och 1899 tolkas i förhållande till 1900. (80 tolkas till exempel som 1980.)
  • Month – obligatoriskt. Ett tal mellan 1 och 12.
  • Day – obligatoriskt. Ett tal mellan 1 och 31.
  • Hour – obligatoriskt. Antal timmar, vanligtvis i intervallet 0 (00:00) till 23 (23:00)
  • Minute – obligatoriskt. Antal minuter, vanligtvis i intervallet 0 till 59.
  • Second – obligatoriskt. Antal sekunder, vanligtvis i intervallet 0 till 59.
  • Millisekunder – valfritt. Antal millisekunder, vanligtvis i intervallet 0 till 999.

Exempel

Date

Om en användare har skrivit

  • 1979 i en textinmatningskontroll med namnet HireYear
  • 3 i en textinmatningskontroll med namnet HireMonth
  • 17 i en textinmatningskontroll med namnet HireDay

formeln returneras 3/17/1979:

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

Tid

Om en användare har skrivit

  • 14 i en textinmatningskontroll med namnet BirthHour
  • 50 i en textinmatningskontroll med namnet BirthMinute
  • 24 i en textinmatningskontroll med namnet BirthSecond

formeln returneras 02:50:24 P:

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

Datum/tid

Om en användare har skrivit

  • 2023 i en textinmatningskontroll med namnet EclipseYear
  • 10 i en textinmatningskontroll med namnet EclipseMonth
  • 28 i en textinmatningskontroll med namnet EclipseDate
  • 13 i en textinmatningskontroll med namnet EclipseHour
  • 14 i en textinmatningskontroll med namnet EclipseMinute
  • 5 i en textinmatningskontroll med namnet EclipseSecond
  • 231 i en textinmatningskontroll med namnet EclipseMillisecond

formeln returneras 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"
)