Dieser Artikel enthält eine Liste von Datumsoperatoren, Methoden und Variablen, die Sie beim Arbeiten mit Datumsangaben in MongoDB verwenden können.
Feldaktualisierungsoperatoren
Operator | Beschreibung |
---|---|
$currentDate | Setzt den Wert eines Feldes auf das aktuelle Datum. Es kann entweder als Datums- oder als Zeitstempeltyp festgelegt werden. Der Standardwert ist Datum. |
Datumsausdrucksoperatoren (Aggregationspipeline)
Die folgenden Operatoren der Aggregationspipeline geben Datumsobjekte oder Komponenten eines Datumsobjekts zurück. Diese können verwendet werden, um Ausdrücke zur Verwendung in den Phasen der Aggregationspipeline zu erstellen.
Operator | Beschreibung |
---|---|
$dateFromParts | Erzeugt ein BSON-Datumsobjekt aus den Bestandteilen des Datums. |
$dateFromString | Konvertiert einen Datums-/Uhrzeit-String in ein Datumsobjekt. |
$dateToParts | Gibt ein Dokument zurück, das die Bestandteile eines Datums enthält. |
$dateToString | Gibt das Datum als String zurück. |
$dayOfMonth | Gibt den Tag des Monats für ein bestimmtes Datum als Zahl zwischen 1 zurück und 31 . |
$dayOfWeek | Gibt den Wochentag für ein bestimmtes Datum als Zahl zwischen 1 zurück (Sonntag) und 7 (Samstag). |
$dayOfYear | Gibt den Tag des Jahres für ein bestimmtes Datum als Zahl zwischen 1 zurück und 366 (Schaltjahr). |
$hour | Gibt die Stunde für ein bestimmtes Datum als Zahl zwischen 0 zurück und 23 . |
$isoDayOfWeek | Gibt die Nummer des Wochentages eines bestimmten Datums im ISO 8601-Format zurück, beginnend bei 1 (für Montag) bis 7 (für Sonntag). |
$isoWeek | Gibt die Wochennummer eines bestimmten Datums im ISO 8601-Format zurück, beginnend bei 1 zu 53 . |
$isoWeekYear | Gibt die Jahreszahl für ein bestimmtes Datum im ISO 8601-Format zurück. |
$millisecond | Gibt die Millisekunden eines bestimmten Datums als Zahl zwischen 0 zurück und 999 . |
$minute | Gibt die Minute für ein bestimmtes Datum als Zahl zwischen 0 zurück und 59 . |
$month | Gibt den Monat für ein bestimmtes Datum als Zahl zwischen 1 zurück (Januar) und 12 (Dezember). |
$second | Gibt die Sekunden für ein gegebenes Datum als Zahl zwischen 0 zurück und 60 (Schaltsekunden). |
$toDate | Wandelt einen Wert in ein Datum um. |
$week | Gibt die Wochennummer für ein bestimmtes Datum als Zahl zwischen 0 zurück (die Teilwoche, die dem ersten Sonntag des Jahres vorausgeht) und 53 (Schaltjahr). |
$year | Gibt das Jahr für ein bestimmtes Datum als Zahl zurück (z. B. 2021 ). |
Methoden
Die folgende Methode kann verwendet werden, um entweder eine Datums-/Uhrzeitzeichenfolge oder ein Datumsobjekt zurückzugeben.
Methode | Beschreibung |
---|---|
Date() | Gibt entweder eine Datums-/Zeitzeichenfolge oder ein Datumsobjekt zurück. Sie können ein Datum angeben. Wenn Sie dies nicht tun, wird das aktuelle Datum/die aktuelle Uhrzeit zurückgegeben. |
Systemvariablen
Die folgenden Systemvariablen können verwendet werden, um einen datetime- oder timestamp-Wert zurückzugeben, wenn eine Aggregationspipeline verwendet wird.
Methode | Beschreibung |
---|---|
NOW | Gibt den aktuellen datetime-Wert zurück. Diese Variable wurde in MongoDB Version 4.2 eingeführt. |
CLUSTER_TIME | Gibt den aktuellen Zeitstempelwert zurück. Nur für Replikatsätze und Sharding-Cluster verfügbar. Diese Variable wurde in MongoDB Version 4.2 eingeführt. |