Datumsformate
Die Plattform ermöglicht eine gewisse Flexibilität bei der Verwendung von Datums-/Zeitfeldern in den HTTP- und MQTT-APIs. Felder sind immer vom Typ String, aber der Inhalt kann unter Verwendung der hier beschriebenen Formate angegeben werden. Dieser Abschnitt beschreibt auch Eigenschaften im Zusammenhang mit der UTC-Handhabung, Zeitzonenkonvertierung und anderen Details.
Trennzeichen
Datumstrennzeichen
Die Zeichen "/" und "-" werden austauschbar als Datumstrennzeichen akzeptiert.
Zeittrennzeichen
Das Zeittrennzeichen muss immer ":" sein.
Datums- und Zeittrennzeichen
Optional kann ein "T" Zeichen verwendet werden, um Datum und Zeit zu trennen. Die folgenden zwei Datumsangaben sind beispielsweise gleichwertig:
2020-02-25 14:35:18
2020-02-25T14:35:18Formate
Datumsformate (ohne Zeit)
Die Plattform unterstützt die folgenden Formate zur Angabe eines Datums.
| Format | Comments |
|---|---|
| yyyy/M/d | Specifies the 4-digit year, followed by month and day, without using zeros to pad month and day. The date separator can be any of the supported ones. |
| yyyy/MM/dd | Specifies the 4-digit year, followed by month and day, using zeros to pad month and day. The date separator can be any of the supported ones. |
Zeitformate
Die Plattform unterstützt die folgenden Formate für die Zeit.
| Format | Comments |
|---|---|
| H:m | Time is specified in 24-hour format, providing hours and minutes, without zero-padding, using the time separator. |
| H:m:s | Time is specified in 24-hour format, providing hours, minutes, and seconds, without zero-padding, using the time separator. |
| HH:mm | Time is specified in 24-hour format, providing hours and minutes, with zero-padding, using the time separator. |
| HH:mm:ss | Time is specified in 24-hour format, providing hours, minutes, and seconds, with zero-padding, using the time separator. |
Epoch-Format
Es ist möglich, ein Datum und eine Zeit im Epoch-Format anzugeben, das heißt als Anzahl der Sekunden seit Mitternacht am 1. Januar 1970, UTC. Das Epoch-Format wird immer in UTC ausgedrückt und erlaubt daher keine Zeitzonenangabe.
| Format | Comments |
|---|---|
| nnnnnnnnnn | Epoch format. In this format, the date and time are reported as a number of seconds from midnight on January 1, 1970, UTC. For example, the date "2010/10/23 02:47:25" corresponds to the value 1287802045. |
Zeitzonenangabe (optional)
Alle APIs erfordern die Verwendung von UTC-Datums- und Zeitangaben. Lokale Zeiten sind jedoch zulässig, solange sie die Zeitzonenverschiebung enthalten.
- Für alle Datums- und Zeitangaben, die keine Zeitzonenverschiebung enthalten (oder die das Suffix "Z" enthalten), wird angenommen, dass sie in UTC ausgedrückt sind.
- Wenn eine Zeitzonenverschiebung angegeben wird, muss sie aus einem "+"- oder "-"-Zeichen bestehen, gefolgt von Stunden und Minuten mit dem Zeittrennzeichen dazwischen.
- Zeitzonenverschiebungen sind nicht mit dem Epoch-Format kompatibel. Das Epoch-Format muss immer in UTC angegeben werden.
Nachfolgend finden Sie einige Beispiele.
| Example | UTC value used | Comments |
|---|---|---|
| 2020-02-21 03:37:14 | 2020-02-21 03:37:14 (same) | No time indication, so UTC is assumed. Corresponds to 03:37:14 on February 21, 2020, UTC time. |
| 2020-02-21 03:37:14Z | 2020-02-21 03:37:14 (same) | The Z suffix indicates the time is expressed in UTC, so this example is equivalent to the previous one. |
| 2020-02-21 20:30:25 -05:00 | 2020/02/22 01:30:25 | Indicates a 5-hour offset to the west. Note that in UTC time, the date advances 5 hours and moves to the next day. |
| 2020-02-21 20:30:25 +05:00 | 2020-02-21 15:30:25 | Indicates a 5-hour offset to the east. |
Datenformate
Bei der Verwendung der APIs über HTTP und MQTT müssen bestimmte Datenformate eingehalten werden, wie nachfolgend beschrieben.
Operatoren
Operatoren ermöglichen das Erstellen von Ausdrücken durch Modifizieren oder Berechnen von Werten aus anderen, die als "Operanden" bezeichnet werden. Abhängig von der Art der durchzuführenden Operation und/oder dem Datentyp, auf den sie angewendet werden, können Operatoren in verschiedene Kategorien eingeteilt werden.