bson | timestamp functions (Zeitstempel-Funktionen)
In diesem Abschnitt werden Funktionen für die Arbeit mit BSON-Zeitstempelwerten beschrieben.
BSON (Binary JSON) ist eine Binärdarstellung von vorwiegend von MongoDB verwendeten JSON-artigen Dokumenten. Einige Systeme, die MongoDB-kompatible APIs implementieren, wie Azure Cosmos DB unterstützen ebenfalls BSON-Dokumente.
Ein BSON-Zeitstempel ist ein 64-Bit-Wert, der aus zwei 32-Bit-Teilen besteht:
•einem time_t-Wert (die höchstwertigen 32 Bits): die Anzahl der Sekunden seit der Unix-Epoche (1970-01-01T00:00:00Z).
•einem ordinal-Wert (die niedrigstwertigen 32 Bits): ein inkremtentierender Zähler, der dazu dient, Operationen, die innerhalb derselben Sekunde stattfinden, zu unterscheiden.
Anmerkung: In BSON-Zeitstempeln wird zum Speichern der Sekunden seit der Unix-Epoche ein 32-Bit-Wert verwendet. Dadurch wird das maximal darstellbare Datum auf das Jahr 2038 beschränkt.
MapForce unterstützt die folgenden BSON-Zeitstempel-Funktionen:
•timestamp-datetime: Gibt den Datums- und Uhrzeitwert, der aus der gespeicherten Anzahl von Sekunden seit der Unix-Epoch konvertiert wurde, in UTC zurück.
•timestamp-ordinal: Extrahiert den Ordnungszahlwert des Zeitstempels.
•to-timestamp: Erstellt anhand eines Datums- und Uhrzeitwerts und einer Ordnungszahl einen Zeitstempel.
Anmerkung: BSON-Zeitstempel sind in erster Linie für die interne Verwendung in MongoDB gedacht. Verwenden Sie für allgemeine Datums- und Uhrzeitwerte den BSON-Datumstyp.
Behandlung von Datumswerten in MapForce
BSON-Datumswerte (Millisekunden seit der Unix-Epoche) werden automatisch in Datums- und Uhrzeitwerte konvertiert und umgekehrt. Nähere Informationen dazu finden Sie in der nachstehenden Tabelle.
Konvertierung | Was passiert |
|---|---|
bson.date > String | Erzeugt einen ISO 8601-Datums- und Uhrzeit-String (z.B. 2020-02-02T01:02:02Z).
Anmerkung: BSON-Datumswerte werden in UTC gespeichert. |
String > bson.date | Parst eine ISO-Datums- und Uhrzeit-String, konvertiert ihn in UTC und speichert ihn als BSON-Datum. |
Nützliche Links