Teilen über

Date, DateTime und Time-Funktionen

  • Artikel

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

Konvertiert Datums- und Zeitkomponenten in einen Datums- oder Uhrzeitwert

Beschreibung

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 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

Datum( Jahr, Monat, Tag )

  • 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.
  • Tag – Erforderlich. Eine Zahl zwischen 1 und 31.

Zeit( 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.
  • Zweites - 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.

DatumUhrzeit( Jahr, Monat, Tag, Stunde, Minute, Sekunde [, Millisekunden ] )

  • 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.
  • Tag – 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.
  • Zweites - 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 Text-Eingabe-Steuerelement namens HireYear
  • 3 in einem Texteingabe-Steuerelement namens HireMonth
  • 17 in einem Texteingabe-Steuerelement namens 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 Texteingabe-Steuerelement namens BirthHour
  • 50 in einem Texteingabe-Steuerelement namens BirthMinute
  • 24 in einem Texteingabe-Steuerelement namens 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 Texteingabe-Steuerelement namens EclipseYear
  • 10 in einem Texteingabe-Steuerelement namens EclipseMonth
  • 28 in einem Texteingabe-Steuerelement namens EclipseDate
  • 13 in einem Texteingabe-Steuerelement namens EclipseHour
  • 14 in einem Texteingabe-Steuerelement namens EclipseMinute
  • 5 in einem Texteingabe-Steuerelement namens EclipseSecond
  • 231 in einem Texteingabe-Steuerelement namens 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"
)