Worum es geht
Auch Datum und Uhrzeit schickst du in einem Filter als Text. CDMS liest den Text in einem festen Format. Welches, hängt vom Feldtyp ab:
| Feldtyp | Format | Beispiel |
|---|---|---|
Datum (DateField) | yyyy-MM-dd | "2026-02-10" |
Uhrzeit (TimeField) | HH:mm:ss | "08:30:00" |
Zeitstempel (DateTimeField) | yyyy-MM-dd HH:mm:ss | "2026-02-10 08:30:00" |
yyyy ist das Jahr, MM der Monat, dd der Tag, HH die Stunde von 00 bis 23, mm die Minute, ss die Sekunde. Alle Teile haben führende Nullen.
Die Werte haben keine Zeitzone. CDMS vergleicht sie so, wie sie in der Datenbank stehen.
Ein Projekt kann die drei Formate über die Einstellungen app.format.date, app.format.time und app.format.datetime ändern. Die Tabelle zeigt den Standard.
Die Systemfelder
_createdOn und _updatedOn sind Zeitstempel. Sie lassen sich wie jedes andere Feld filtern und sortieren:
{ "key": "_createdOn", "value": "2026-09-01 00:00:00", "param": "SAMEORAFTER" }Siehe Systemfelder.
Zeiträume
Einen Zeitraum baust du aus zwei Filtern in einer UND-Gruppe: Beginn mit SAMEORAFTER (einschließlich), Ende mit BEFORE (ausschließlich).
{
"type": "AND",
"filter": [
{ "key": "dueOn", "value": "2026-02-01", "param": "SAMEORAFTER" },
{ "key": "dueOn", "value": "2026-03-01", "param": "BEFORE" }
]
}flowchart LR
A["31.01."] --- B["01.02.<br/>SAMEORAFTER<br/>gehört dazu"]
B --- C["… Februar …"]
C --- D["28.02."]
D --- E["01.03.<br/>BEFORE<br/>gehört nicht dazu"]
Alle Ausprägungen
Wann: Feld dueOn vom Typ Datum.
{ "key": "dueOn", "value": "2026-02-10", "param": "EQ" } findet genau diesen Tag.
Ergebnis: Alle mit Fälligkeit am 10.02.2026.
Wann: Feld vom Typ Uhrzeit, z. B. opensAt.
{ "key": "opensAt", "value": "09:00:00", "param": "BEFORE" }
Ergebnis: Alles, was vor 9 Uhr öffnet.
Wann: Feld startedAt vom Typ Zeitstempel.
{ "key": "startedAt", "value": "2026-02-10 08:00:00", "param": "AFTER" }
Ergebnis: Alles nach dem 10.02.2026, 8 Uhr.
Wann: Du willst alle Einträge eines Tages aus einem Zeitstempelfeld.
EQ mit "2026-02-10" geht nicht, dem Wert fehlt die Uhrzeit. Nimm einen Zeitraum: SAMEORAFTER "2026-02-10 00:00:00" und BEFORE "2026-02-11 00:00:00".
Ergebnis: Alle Einträge vom 10.02.2026.
Wann: "10.02.2026", "2026-02-10T08:00:00" oder ein Zeitstempel ohne Uhrzeit.
CDMS kann den Text nicht lesen und lehnt die Suche ab.
Ergebnis: 400 wrong-value-in-where|dueOn|10.02.2026. Siehe Wenn ein Filter nicht passt.
Welche Operatoren?
Für Datum, Uhrzeit und Zeitstempel gibt es EQ, NEQ, IN, BEFORE, AFTER, SAMEORBEFORE, SAMEORAFTER, ISNULL und ISNOTNULL. LIKE gibt es für diese Felder nicht. Siehe Alle Filteroperatoren.