Funktionen „DateValue“, „TimeValue“ und „DateTimeValue“

  • Artikel

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

Konvertiert ein Datum und/oder eine Uhrzeit in einer Zeichenfolge in einen Datum/Uhrzeit-Wert

Beschreibung

  • Die Funktion DateValue wandelt eine Datumszeichenfolge (zum Beispiel „01.10.2014“) in einen Datums-/Uhrzeitwert um.

  • Die Funktion TimeValue wandelt eine Zeitzeichenfolge (z. B. „12:15 Uhr“) in einen Datums-/Uhrzeitwert um.

  • Die Funktion DateTimeValue wandelt eine Datums- und Uhrzeitzeichenfolge (zum Beispiel „10. Januar, 2013 12:13 Uhr“) in einen Datums-/Uhrzeitwert um.

Die Funktion DateValue ignoriert sämtliche Zeitinformationen in der Datumszeichenfolge, und die Funktion TimeValue ignoriert sämtliche Datumsinformationen in der Uhrzeitzeichenfolge.

Notiz

Die Funktionen „DateValue“, „TimeValue“ und „DateTimeValue“ verwenden standardmäßig die Sprache aus den Einstellungen des aktuellen Benutzers. Sie können es überschreiben, um sicherzustellen, dass Zeichenfolgen richtig interpretiert werden. Beispielsweise wird „10/1/1920“ als der 1. Oktober in "en" and as 10. Januar in "fr".

Datumsangaben müssen eines der folgenden Formate aufweisen:

  • MM/TT/JJJJ oder MM-TT-JJJJ
  • TT/MM/JJJJ oder TT-MM-JJJJ
  • JJJJ/MM/TT oder JJJJ-MM-TT
  • MM/TT/JJ oder MM-TT-JJ
  • TT/MM/JJ oder TT-MM-JJ
  • TT Mon JJJJ
  • Monat DD, YYYY

Lesen Sie zum Konvertieren von numerischen Datums-, Monats- und Jahreskomponenten Date.
Lesen Sie zum Konvertieren aus numerischen Stunden-, Minuten- und Sekundenkomponenten Time.

Weitere Informationen finden Sie unter:

Syntax

Datumswert( Zeichenfolge [, Sprache ])
Datum/Uhrzeit-Wert( Zeichenfolge [, Sprache ])
Zeitwert( Zeichenfolge [, Sprache ])

  • String – Erforderlich. Eine Textzeichenfolge, die einen Datum-, Uhrzeit- oder einen Datum/Uhrzeit-Wert enthält.
  • Sprache – Optional. Eine Sprachzeichenfolge, wie man sie durch die ersten beiden Zeichen des Rückgabewertes der Language-Funktion erhält. Wenn nicht anders angegebenen, wird die Sprache der Einstellungen des aktuellen Benutzers verwendet.

Datumswert( Untypisiert )
Datum/Uhrzeit-Wert( Untypisiert )
Zeitwert( Untypisiert )

  • Nicht typisiert – Erforderlich. nicht typisiertes Objekt das ein Datum oder eine Uhrzeit darstellt. Zulässige Werte hängen vom nicht typisierten Anbieter ab. Für JSON wird erwartet, dass das nicht typisierte Objekt eine JSON-Zeichenfolge ist, die ein Datum und eine Uhrzeit im ISO 8601-Format enthält. Datums- oder Zeitangaben in anderen Formaten führen zu einem Fehler. Erwägen Sie, zuerst solche Werte in Text umzuwandeln, dann in ein Datum oder eine Uhrzeit. Beachten Sie, dass Zeitzonen und gebietsschemabezogene Formate wichtige Überlegungen bei der Kommunikation mit externen Systemen sind.

Beispiele

DateValue

Wenn Sie 10/11/2014 in ein Texteingabe-Steuerelement mit dem Namen StartDate eingegeben haben, und Sie dann die Text-Eigenschaft einer Bezeichnung für diese Formeln festgelegt haben, gibt es mehrere Möglichkeiten:

  • Konvertieren Sie ein Datum aus einer Zeichenfolge im Gebietsschema des Benutzers und zeigen Sie das Ergebnis als langes Datum an.

    Text( DateValue( Startdate.Text ), DateTimeFormat.LongDate )

    Ist das Gerät auf das Gebietsschema en eingestellt, zeigt die Bezeichnung Samstag, 11. Oktober 2014.

    Notiz

    Sie können mehrere Optionen mit der Aufzählung DateTimeFormat verwenden. Geben Sie zum Anzeigen einer Liste mit Optionen den Parameter gefolgt von einem Punkt (.) in der Formelleiste ein oder überprüfen Sie Text-Funktionsreferenz.

  • Konvertieren Sie ein Datum aus einer Zeichenfolge im Gebietsschema Französisch und zeigen Sie das Ergebnis als langes Datum an. In diesem Beispiel werden die Monate und der Tag des Monats anders interpretiert als Englisch.

    Text( DateValue( Startdate.Text, "fr" ), DateTimeFormat.LongDate )

    Ist das Gerät auf das Gebietsschema en eingestellt, zeigt die Bezeichnung Montag, 10. November 2014.

Wenn Sie stattdessen 20. Oktober 2014 eingegeben haben:

  • Konvertieren eines Datums aus einer Zeichenfolge im Gebietsschema des Benutzers und Berechnen der Differenz zwischen zwei Tagen in Tagen

    DateDiff( DateValue( Startdate.Text ), Today() )

    Ist das Gerät auf das Gebietsschema en eingestellt, wird die Bezeichnung als 9 angezeigt, womit die Anzahl der Tage zwischen dem 11. und 20. Oktober angegeben wird. Die DateDiff-Funktion kann auch die Differenz in Monaten, Quartalen oder Jahren angezeigt.

DateTimeValue

Wenn Sie 10/11/2014 1:50:24.765 PM in ein Texteingabe-Steuerelement mit dem Namen Start eingegeben haben, und Sie anschließend die Text-Eigenschaft einer Bezeichnung auf die folgende Formel festgelegt haben, gibt es mehrere Möglichkeiten:

  • Konvertieren Sie sowohl eine Datums- als auch eine Zeitzeichenfolge in das aktuelle Gebietsschema.

    Text( DateTimeValue( Start.Text ), DateTimeFormat.LongDateTime )

    Ist das Gerät auf das Gebietsschema en eingestellt, zeigt die Bezeichnung Samstag, 11. Oktober 2014, 1:50:24 PM.

    Notiz

    Sie können mehrere Optionen mit der Aufzählung DateTimeFormat verwenden. Geben Sie zum Anzeigen einer Liste mit Optionen den Parameter gefolgt von einem Punkt (.) in der Formelleiste ein oder überprüfen Sie Text-Funktionsreferenz.

  • Konvertieren Sie sowohl eine Datums- als auch eine Zeitzeichenfolge in das französische Gebietsschema. Monat und Tag des Monats werden unterschiedlich interpretiert.

    Text( DateTimeValue( Start.Text, "fr"), DateTimeFormat.LongDateTime )

    Ist das Gerät auf das Gebietsschema en eingestellt, zeigt die Bezeichnung Montag, 10. November 2014, 1:50:24 PM.

  • Konvertieren Sie sowohl eine Datums- als auch eine Zeitzeichenfolge in das Gebietsschema des Benutzers und zeigen Sie das Ergebnis mit einem Bruchteil einer Sekunde an.

    Text( DateTimeValue( Start.Text ), "dddd, mmmm dd, yyyy hh:mm:ss.fff AM/PM" )

    Ist das Gerät auf das Gebietsschema en eingestellt, zeigt die Bezeichnung Samstag, 11. Oktober 2014, 01:50:24.765 PM.

    Als Alternative können Sie hh:mm:ss.f oder hh:mm:ss.ff angeben, um die Zeit auf das nächste Zehntel oder Hundertstel einer Sekunde zu runden.

TimeValue

Benennen Sie ein Texteingabe-Steuerelement FinishedAt, und legen Sie die Text-Eigenschaft einer Bezeichnung auf folgende Formel fest:

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)
  • Wenn Sie 4:59:59.999 PM in das FinishedAt-Steuerelement eingegeben haben, zeigt die Bezeichnung „You made it!“ (Geschafft!) an
  • Wenn Sie 5:00:00.000 PM in das FinishedAt-Steuerelement eingeben, zeigt die Bezeichnung „Too late!“ (Zu spät!) an