Dynamische Suche nach Dokumenten in Datumsfeldern

Sebastian Bartsch Aktualisiert von Sebastian Bartsch

Die nachfolgend beschriebene Funktion ist ab Version 5.0.21175 verfügbar

Mit Hilfe der nachfolgend beschriebenen Funktionen können dynamische datumsbasierte Suchzeiträume erzeugt werden. Dadurch erhalten Sie unter anderem die Möglichkeit immer die Dokumente des letzten Monats oder Quartals zu exportieren ohne fortlaufend Veränderungen an der Konfiguration vorzunehmen.

Funktionen mit dem Präfix SEARCH_ erstellen direkt eine Zeichenfolge die alle Suchparameter enthält um in einem Zeitraum zu Suchen. Alle anderen Funktionen liefern nur ein Datum.

Vordefinierte Suchzeiträume

Verwenden Sie diese Funktionen um direkt eine Suchzeichenfolge zu erzeugen.

Die Funktion SEARCH_YEAR() wird dabei zum Beispiel durch ~~[gte]~~01.01.2021~~[lte]~~31.12.2021 ersetzt.

Diese Funktionen dürfen nur exklusiv verwendet werden. Es dürfen nicht mehrere Funktionen kombiniert werden.

Funktion

Beschreibung

SEARCH_YEAR()

Gibt einen Suchzeitraum vom 01.01-31.12. des aktuellen Jahres zurück.

SEARCH_MONTH()

Gibt einen Suchzeitraum von ersten bis zum letzten Tag des aktuellen Monats zurück.

SEARCH_QUARTER()

Gibt einen Suchzeitraum vom ersten Tag bis zum letzten Tag des aktuellen Quartals zurück.

Durch die Angabe eines Parameters wie -1 oder +1 wird der Rückgabewert entsprechend angepasst. Es können beliebige Wert angegeben werden. Die Angabe des Zeichens -/+ ist immer erforderlich.

Die Funktionen verarbeiten den Parameter kontextabhängig. So liefert YEAR(-1) die Jahreszahl des Vorjahres, während MONTH(-1) die Monatszahl des Vormonats zurückgibt.

Flexible Suchzeiträume

Die Zusammenstellung der Suchzeichenfolge erfolgt hier nicht automatisch - ermöglicht Ihnen jedoch flexiblere Zeiträume zu definieren. Hierfür steht die DATE()-Funktion zur Verfügung.

Durch die Angabe eines Parameters wie -1D oder +1D wird der Rückgabewert entsprechend angepasst. Es können beliebige Wert angegeben werden. Die Angabe des Zeichens -/+ ist immer erforderlich, ebenso die Angabe welcher Teil des Datums modifiziert werden soll.

Verwenden Sie den Buchstaben D für Tage, M für Monate und Y für Jahre.

DATE()

24.06.2021

DATE(+10D)

04.07.2021

DATE(-1M)

23.05.2021

Beispiel "Suchen innerhalb der letzten 2 Wochen"

~~[gte]~~DATE(-14D)~~[lte]~~DATE(-1D) dies ergibt ~~[gte]~~10.06.2021~~[lte]~~23.06.2021

Mehr Informationen zu den verwendeten Operatoren finden Sie in der DocXporter Dokumentation.

Parameter

In den oben genannten Beispielen wurden kein Wert innerhalb der Klammern der Funktionen verwendet. Somit wird immer das aktuelle Datum als Ausgangspunkt für das Ergebnis verwendet.

Durch die Angabe eines Parameters wie -1 oder +1 wird der Rückgabewert entsprechend angepasst. Es können beliebige Wert angegeben werden. Die Angabe des Zeichens -/+ ist immer erforderlich.

Die Funktionen verarbeiten den Parameter kontextabhängig. So liefert YEAR(-1) die Jahreszahl des Vorjahres, während MONTH(-1) die Monatszahl des Vormonats zurückgibt.

Bei den Gruppe 1 Funktionen wirkt sich der Funktionsparameter ebenfalls kontextabhängig aus. So werden hier entsprechend Vorjahreszeiträume oder Vormonatszeiträume zurückgegeben.

Wie waren wir?

DocXporter - Export für Addison

Support