Date, DateTime und Time-Funktionen

Gilt für: Canvas-Apps Desktop-Flows Modellgesteuerte Apps Power Platform CLI

Konvertiert Datums- und Zeitkomponenten in einen Datums- oder Uhrzeitwert

Description

Die Date-Funktion konvertiert einzelne Werte für Jahr, Monat und Tag in einen Datums- oder Uhrzeitwert. Der Uhrzeitanteil ist Mitternacht.

  • Wenn der Wert für „Year“ zwischen 0 und 1899 (einschließlich) liegt, fügt die Funktion den Wert zu 1900 hinzu, um das Jahr zu berechnen. 70 wird auf diese Weise zu 1970.
  • Wenn der Wert für „Month“ kleiner als 1 oder größer als 12 ist, subtrahiert oder addiert das Ergebnis die entsprechende Anzahl von Monaten ab dem Anfang des angegebenen Jahres.
  • Wenn der Wert für „Day“ größer als die Anzahl der Tage im angegebenen Monat ist, fügt die Funktion die jeweilige Anzahl von Tagen dem ersten Tag des Monats hinzu und gibt das entsprechende Datum aus einem nachfolgenden Monat zurück. Wenn der Wert für „Day“ kleiner als 1 ist, subtrahiert die Funktion die entsprechende Anzahl von Tagen plus 1 vom ersten Tag des angegebenen Monats.

Die Time-Funktion konvertiert die einzelnen Werte für Stunde, Minute und Sekunde und optional Millisekunde in einen Datums- oder Uhrzeitwert. Dem Ergebnis ist kein Datum zugeordnet.

Die Funktion DateTime kombiniert das Datum und die Zeit Funktionen in einer einzigen Funktion, die sowohl Datums- als auch Uhrzeitargumente übernimmt und einen Datums-/Uhrzeitwert zurückgibt, der sowohl Datums- als auch Uhrzeitkomponenten enthält.

Weitere Informationen dazu, wie Sie eine Zeichenkette in einen Wert konvertieren, finden Sie unter den DateValue, TimeValue und DateTimeValue-Funktionen.

Weitere Informationen finden Sie unter Working with dates and times (Arbeiten mit Datums- und Uhrzeitangaben).

Syntax

Date( Year, Month, Day )

  • Jahr - Erforderlich. Zahlen größer als 1899 werden als absolute Zahlen interpretiert (1980 wird als 1980 interpretiert), Zahlen zwischen 0 und 1899 werden als relativ zu 1900 interpretiert. (So wird beispielsweise 80 als 1980 interpretiert.)
  • Monat - Erforderlich. Eine Zahl zwischen 1 und 12.
  • Day - Erforderlich. Eine Zahl zwischen 1 und 31.

Time( Stunde, Minute, Sekunde [, Millisekunden ] )

  • Stunde - Erforderlich. Anzahl der Stunden, normalerweise im Bereich von 0 (12:00 Uhr) bis 23 (23:00 Uhr).
  • Minute - Erforderlich. Anzahl von Minuten, in der Regel im Bereich von 0 bis 59.
  • Sekunde - Erforderlich. Anzahl von Sekunden, in der Regel im Bereich von 0 bis 59.
  • Millisekunden – Optional. Anzahl von Millisekunden, in der Regel im Bereich von 0 bis 999.

DateTime( Jahr, Monat, Tag, Stunde, Minute, Sekunde [, Millisekunde ] )

  • Jahr - Erforderlich. Zahlen größer als 1899 werden als absolute Zahlen interpretiert (1980 wird als 1980 interpretiert), Zahlen zwischen 0 und 1899 werden als relativ zu 1900 interpretiert. (So wird beispielsweise 80 als 1980 interpretiert.)
  • Monat - Erforderlich. Eine Zahl zwischen 1 und 12.
  • Day - Erforderlich. Eine Zahl zwischen 1 und 31.
  • Stunde - Erforderlich. Anzahl der Stunden, normalerweise im Bereich von 0 (12:00 Uhr) bis 23 (23:00 Uhr)
  • Minute - Erforderlich. Anzahl von Minuten, in der Regel im Bereich von 0 bis 59.
  • Sekunde - Erforderlich. Anzahl von Sekunden, in der Regel im Bereich von 0 bis 59.
  • Millisekunden – Optional. Anzahl von Millisekunden, in der Regel im Bereich von 0 bis 999.

Beispiele

Date

Wenn ein Benutzer eingegeben hat

  • 1979 in einem Texteingabesteuerelement mit dem Namen HireYear
  • 3 in einem Texteingabesteuerelement mit dem Namen HireMonth
  • 17 in einem Texteingabesteuerelement mit dem Namen HireDay

Diese Formel könnte Folgendes zurückgeben 3/17/1979:

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

Uhrzeit

Wenn ein Benutzer eingegeben hat

  • 14 in einem Texteingabesteuerelement mit dem Namen BirthHour
  • 50 in einem Texteingabesteuerelement mit dem Namen BirthMinute
  • 24 in einem Texteingabesteuerelement mit dem Namen BirthSecond

Diese Formel könnte Folgendes zurückgeben 02:50:24 P:

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

DateTime

Wenn ein Benutzer eingegeben hat

  • 2023 in einem Texteingabesteuerelement mit dem Namen EclipseYear
  • 10 in einem Texteingabesteuerelement mit dem Namen EclipseMonth
  • 28 in einem Texteingabesteuerelement mit dem Namen EclipseDate
  • 13 in einem Texteingabesteuerelement mit dem Namen EclipseHour
  • 14 in einem Texteingabesteuerelement mit dem Namen EclipseMinute
  • 5 in einem Texteingabesteuerelement mit dem Namen EclipseSecond
  • 231 in einem Texteingabesteuerelement mit dem Namen EclipseMillisecond

Diese Formel könnte Folgendes zurückgeben 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"
)