Datums- und Uhrzeitfunktionen
Erstellt für:
- Benutzende
Datums- und Uhrzeitfunktionen werden verwendet, um Datums- und Uhrzeitvorgänge für Werte in Profile Query Language (PQL) auszuführen. Weitere Informationen zu anderen PQL-Funktionen finden Sie in der Profile Query Language Übersicht.
Aktueller Monat
Die Funktion currentMonth
gibt den aktuellen Monat als Ganzzahl zurück.
Format
currentMonth()
Beispiel
Die folgende PQL-Abfrage prüft, ob der Geburtsmonat der Person der aktuelle Monat ist.
person.birthMonth = currentMonth()
Monat abrufen
Die Funktion getMonth
gibt den Monat als Ganzzahl basierend auf einem bestimmten Zeitstempel zurück.
Format
{TIMESTAMP}.getMonth()
Beispiel
Die folgende PQL-Abfrage prüft, ob der Geburtsmonat der Person im Juni liegt.
person.birthdate.getMonth() = 6
Aktuelles Jahr
Die currentYear
gibt das aktuelle Jahr als Ganzzahl zurück.
Format
currentYear()
Beispiel
Die folgende PQL-Abfrage prüft, ob das Produkt im aktuellen Jahr verkauft wurde.
product.saleYear = currentYear()
Jahr abrufen
Die getYear
gibt das Jahr als Ganzzahl zurück, basierend auf einem bestimmten Zeitstempel.
Format
{TIMESTAMP}.getYear()
Beispiel
Die folgende PQL-Abfrage prüft, ob das Geburtsjahr der Person in die Jahre 1991, 1992, 1993, 1994 oder 1995 fällt.
person.birthday.getYear() in [1991, 1992, 1993, 1994, 1995]
Aktueller Tag des Monats
Die currentDayOfMonth
gibt den aktuellen Tag des Monats als Ganzzahl zurück.
Format
currentDayOfMonth()
Beispiel
Die folgende PQL-Abfrage prüft, ob der Geburtstag der Person mit dem aktuellen Tag des Monats übereinstimmt.
person.birthDay = currentDayOfMonth()
Tag des Monats abrufen
Die getDayOfMonth
gibt den Tag als Ganzzahl basierend auf einem bestimmten Zeitstempel zurück.
Format
{TIMESTAMP}.getDayOfMonth()
Beispiel
Die folgende PQL-Abfrage prüft, ob der Artikel innerhalb der ersten 15 Tage des Monats verkauft wurde.
product.sale.getDayOfMonth() <= 15
Tritt auf
Die occurs
vergleicht die angegebene Zeitstempelfunktion mit einem festen Zeitraum als booleschen Wert.
Format
Die occurs
kann in einem der folgenden Formate geschrieben werden:
{TIMESTAMP} occurs {COMPARISON} {INTEGER} {TIME_UNIT} {DIRECTION} {TIME}
{TIMESTAMP} occurs {DIRECTION} {TIME}
{TIMESTAMP} occurs (on) {TIME}
{TIMESTAMP} occurs between {TIME} and {TIME}
{COMPARISON}
>
, >=
, <
, <=
, =
, !=
. Weitere Informationen zu den Vergleichsfunktionen finden Sie im Dokument zu Vergleichsfunktionen.{INTEGER}
{TIME_UNIT}
millisecond(s)
, second(s)
, minute(s)
, hour(s)
, day(s)
, week(s)
, month(s)
, year(s)
, decade(s)
, century
, centuries
, millennium
, millennia
.{DIRECTION}
before
, after
, from
.{TIME}
today
, now
, yesterday
, tomorrow
), eine relative Zeiteinheit (this
, last
oder next
gefolgt von einer Zeiteinheit) oder ein Zeitstempelattribut sein.on
ist optional. Sie dient dazu, die Lesbarkeit für einige Kombinationen zu verbessern, z. B. timestamp occurs on date(2019,12,31)
.Beispiel
Die folgende PQL-Abfrage prüft, ob der Artikel letzte Woche verkauft wurde.
product.saleDate occurs last week
Die folgende PQL-Abfrage prüft, ob ein Artikel zwischen dem 8. Januar 2015 und dem 1. Juli 2017 verkauft wurde.
product.saleDate occurs between date(2015, 1, 8) and date(2017, 7, 1)
Jetzt
now
ist ein reserviertes Wort, das den Zeitstempel der PQL-Ausführung darstellt.
Beispiel
Die folgende PQL-Abfrage prüft, ob ein Artikel genau drei Stunden zuvor verkauft wurde.
product.saleDate occurs = 3 hours before now
Heute
today
ist ein reserviertes Wort, das den Zeitstempel des Starts des Tages der PQL-Ausführung darstellt.
Beispiel
Die folgende PQL-Abfrage prüft, ob der Geburtstag einer Person vor drei Tagen war.
person.birthday occurs = 3 days before today
Nächste Schritte
Nachdem Sie sich mit Datums- und Uhrzeitfunktionen vertraut gemacht haben, können Sie diese in Ihren PQL-Abfragen verwenden. Weitere Informationen zu anderen PQL-Funktionen finden Sie in Profil Query Language – Übersicht.