Die Funktionen „DateAdd“, „DateDiff“ und „TimeZoneOffset“ in PowerAppsDateAdd, DateDiff, and TimeZoneOffset functions in PowerApps

Dienen zum Hinzufügen zu oder Auffinden des Unterschiedes bei Datum-/Uhrzeit-Werten und Konvertieren zwischen Ortszeit und UTC.Adds to or finds the difference in date/time values and converts between local time and UTC.

BeschreibungDescription

Die DateAdd-Funktion fügt einem Datum/Uhrzeit-Wert eine Anzahl von Einheiten hinzu.The DateAdd function adds a number of units to a date/time value. Das Ergebnis ist ein neuer Datum/Uhrzeit-Wert.The result is a new date/time value. Sie können auch eine Anzahl von Einheiten von einem Datum/Uhrzeit-Wert subtrahieren, indem Sie einen negativen Wert angeben.You can also subtract a number of units from a date/time value by specifying a negative value.

Die DateDiff-Funktion gibt die Differenz zwischen zwei Datum/Uhrzeit-Werten zurück.The DateDiff function returns the difference between two date/time values. Das Ergebnis ist eine Anzahl von Einheiten.The result is a number of units.

Mögliche Einheiten für beide Funktionen sind Millisekunden, Sekunden, Minuten, Stunden, Tage, Monate, Quartale oder Jahre.For both functions, units can be Milliseconds, Seconds, Minutes, Hours, Days, Months, Quarters, or Years. Beide Funktionen verwenden standardmäßig Tage als Einheiten.By default, both functions use Days as units.

Die TimeZoneOffset-Funktion gibt die Anzahl der Minuten zwischen Ortszeit des Benutzers und UTC (Coordinated Universal Time) zurück.The TimeZoneOffset function returns the number of minutes between the user's local time and UTC (Coordinated Universal Time).

Sie können DateAdd mit TimeZoneOffset zum Konvertieren zwischen der Ortszeit des Benutzers und UTC (Coordinated Universal Time) verwenden.You can use DateAdd with the TimeZoneOffset to convert between the user's local time and UTC (Coordinated Universal Time). Durch Hinzufügen von TimeZoneOffset wird eine Ortszeit in UTC konvertiert, und durch Subtrahieren (Hinzufügen eines negativen Werts) wird UTC in die Ortszeit konvertiert.Adding TimeZoneOffset will convert a local time to UTC, and subtracting it (adding the negative) will convert from UTC to local time.

Weitere Informationen finden Sie unter Working with dates and times (Arbeiten mit Datums- und Uhrzeitangaben).Also see working with dates and times for more information.

SyntaxSyntax

DateAdd( DateTime, Addition [, Units ] )DateAdd( DateTime, Addition [, Units ] )

  • DatumUhrzeit: erforderlich.DateTime - Required. Der zu verarbeitende Datum/Uhrzeit-WertDate/time value to operate on.
  • Addition: erforderlich.Addition - Required. Die DateTime hinzuzufügende Anzahl in Einheiten.Number, in Units, to add to the DateTime.
  • Einheiten: optional.Units - Optional. Mögliche Typen von Einheiten sind Millisekunden, Sekunden, Minuten, Stunden, Tage, Monate, Quartale oder Jahre.The type of Units to add: Milliseconds, Seconds, Minutes, Hours, Days, Months, Quarters, or Years. Wenn nicht angegeben, werden Tage verwendet.If not specified, Days are used.

DateDiff( StartDateTime, EndDateTime [, Units ] )DateDiff( StartDateTime, EndDateTime [, Units ] )

  • AnfangDatumUhrzeit: erforderlich.StartDateTime - Required. Der Anfangs-Datum/Uhrzeit-WertStarting date/time value.
  • EndeDatumUhrzeit: erforderlich.EndDateTime - Required. Der End-Datum/Uhrzeit-WertEnding date/time value.
  • Einheiten: optional.Units - Optional. Mögliche Typen von Einheiten sind Millisekunden, Sekunden, Minuten, Stunden, Tage, Monate, Quartale oder Jahre.The type of Units to add: Milliseconds, Seconds, Minutes, Hours, Days, Months, Quarters, or Years. Wenn nicht angegeben, werden Tage verwendet.If not specified, Days are used.

TimeZoneOffset( [ DateTime ] )TimeZoneOffset( [ DateTime ] )

  • DateTime: Optional.DateTime - Optional. Datum/Uhrzeit-Wert, für den der Offset zurückgegeben werden soll.Date/time value for which to return the offset. Standardmäßig wird der aktuelle Datum/Uhrzeit-Wert verwendet.By default, the current date/time is used.

BeispieleExamples

Bei allen diesen Beispielen wird davon ausgegangen, dass der Datum/Uhrzeit-Wert der 15. Juli 2013, 13:02 Uhr ist.In all of these examples, assume that the current date and time is July 15, 2013, 1:02 PM.

Einfache DateAdd-FunktionSimple DateAdd

FormelFormula BeschreibungDescription ErgebnisResult
Text( DateAdd( Now(), 3 ),
"dd-mm-yyyy hh:mm" )
Text( DateAdd( Now(), 3 ),
"dd-mm-yyyy hh:mm" )
Dem aktuellen Datum/Uhrzeit-Wert werden drei Tage (Standardeinheiten) hinzugefügt.Adds three days (default units) to the current date and time. "18-07-2013 13:02""18-07-2013 13:02"
Text( DateAdd( Now(), 4, Stunden ),
"dd-mm-yyyy hh:mm" )
Text( DateAdd( Now(), 4, Hours ),
"dd-mm-yyyy hh:mm" )
Dem aktuellen Datum/Uhrzeit-Wert werden vier Stunden hinzugefügt.Add four hours to the current date and time. "15-07-2013 17:02""15-07-2013 17:02"
Text( DateAdd( Today(), 1, Monate ),
"dd-mm-yyyy hh:mm" )
Text( DateAdd( Today(), 1, Months ),
"dd-mm-yyyy hh:mm" )
Fügt dem aktuellen Datum einen Monat hinzu. Ohne Uhrzeit als Today wird keine Zeitangabe zurückgegeben.Adds one month to the current date, without time as Today doesn't return a time component. "15-08-2013 00:00""15-08-2013 00:00"
Text( DateAdd( Now(), ‑30, Minuten ),
"dd-mm-yyyy hh:mm" )
Text( DateAdd( Now(), ‑30, Minutes ),
"dd-mm-yyyy hh:mm" )
Subtrahiert 30 Minuten vom dem aktuellen Datum/Uhrzeit-Wert.Subtracts 30 minutes from the current date and time. "15-07-2013 12:32""15-07-2013 12:32"

Einfache DateDiff-FunktionSimple DateDiff

FormelFormula BeschreibungDescription ErgebnisResult
DateDiff( Now(), DateValue("1/1/2014") )DateDiff( Now(), DateValue("1/1/2014") ) Gibt die Differenz zwischen den zwei Einheiten in der Standardeinheit Tage zurück.Returns the difference between the two units in the default units of Days 170170
DateDiff( Now(), DateValue("1/1/2014"), Monate )DateDiff( Now(), DateValue("1/1/2014"), Months ) Gibt die Differenz zwischen den beiden Werten in Monaten zurück.Returns the difference between the two values in Months 66
DateDiff( Now(), Today(), Minuten )DateDiff( Now(), Today(), Minutes ) Gibt die Differenz zwischen dem aktuellen Datum/Uhrzeit-Wert und dem aktuellen Datum nur in Minuten (ohne Uhrzeit) zurück.Returns the difference between the current date/time and the current date only (no time) in minutes. Da Now (jetzt) später als Today (heute) ist, ist das Ergebnis negativ.Since the Now is later than Today the result will be negative. -782-782

Konvertieren in UTCConverting to UTC

Fügen Sie zum Konvertieren in UTC (Coordinated Universal Time) TimeZoneOffset der angegebenen Uhrzeit hinzu.To convert to UTC (Coordinated Universal Time), add the TimeZoneOffset for the given time.

Angenommen, der aktuelle Datum/Uhrzeit-Wert ist der 15. Juli 2013, 13:02 Uhr in Pacific Daylight Time (PDT, UTC-7).For example, imagine the current date and time is July 15, 2013, 1:02 PM in Pacific Daylight Time (PDT, UTC-7). Verwenden Sie zum Bestimmen der aktuellen Uhrzeit in UTC Folgendes:To determine the current time in UTC, use:

  • DateAdd( Now(), TimeZoneOffset(), Minuten )DateAdd( Now(), TimeZoneOffset(), Minutes )

TimeZoneOffset ist standardmäßig auf die aktuelle Uhrzeit festgelegt, sodass Sie kein Argument dafür übergeben müssen.TimeZoneOffset defaults to the current time, so you don't need to pass it an argument.

Um das Ergebnis anzuzeigen, verwenden Sie die Text-Funktion im Format dd-mm-yyyy hh:mm, die 15-07-2013 20:02 zurückgibt.To see the result, use the Text function with the format dd-mm-yyyy hh:mm, which will return 15-07-2013 20:02.

Konvertieren aus UTCConverting from UTC

Zum Konvertieren aus UTC subtrahieren Sie TimeZoneOffset (durch Hinzufügen eines negativen Werts) von der angegebenen Uhrzeit.To convert from UTC, subtract the TimeZoneOffset (by adding the negative) for the given time.

Angenommen, das UTC-Datum und die Uhrzeit 15. Juli 2013, 20:02 Uhr werden in einer Variablen namens StartTime gespeichert.For example, imagine the UTC date and time July 15, 2013, 8:02 PM is stored in a variable named StartTime. Verwenden Sie zum Anpassen der Zeit für die Zeitzone des Benutzers Folgendes:To adjust the time for the user's time zone, use:

  • DateAdd( StartTime, -TimeZoneOffset( StartTime ), Minuten )DateAdd( StartTime, -TimeZoneOffset( StartTime ), Minutes )

Beachten Sie das negative Vorzeichen vor TimeZoneOffset, damit der Offset subtrahiert und nicht addiert wird.Note the negative sign before TimeZoneOffset to subtract the offset rather than add it.

Um das Ergebnis anzuzeigen, verwenden Sie die Text-Funktion im Format dd-mm-yyyy hh:mm, die 15-07-2013 13:02 in der PDT-Zeit zurückgibt.To see the result, use the Text function with the format dd-mm-yyyy hh:mm, which will result in 15-07-2013 13:02 if you're in Pacific Daylight Time.