Die Textfunktion DateOffset() ist für relationale Tabellen sowie für Datumswerte in Planning- und Essbase-Rastern gültig und berechnet ein neues Datum, indem das referenzierte Datum um den angegebenen Betrag verschoben wird. Für den Verschiebungsbetrag wird die angegebene Einheit (Tage, Monate oder Jahre) verwendet. Der Parameter TableName ist optional, wenn die Textfunktion in einer relationalen Tabelle enthalten ist oder der Bericht nur eine relationale Tabelle enthält. Andernfalls muss der Parameter TableName angegeben werden. Der Parameter row-reference ist optional. Wenn er nicht angegeben ist, wird die aktuelle Zeile verwendet. Der Parameter calendar-unit ist erforderlich und muss als Tag, Monat oder Jahr angegeben werden.
Syntax
DateOffset("Grid/TableName", row-reference, col-reference, calendar-unit, offsetAmount)
Parameter
Grid/TableName - Dieser Parameter ist optional, wenn die Textfunktion in einer Textzelle des Rasters/der relationalen Tabelle verwendet wird. Wenn die Textfunktion in einem Textobjekt verwendet wird, ist der Parameter Grid/TableName optional, wenn der Bericht nur ein Raster/eine relationale Tabelle enthält. Andernfalls ist der Parameter Grid/TableName erforderlich.
row-reference - Dieser Parameter ist optional. Wenn der Parameter row-reference nicht angegeben ist, wird die aktuelle Zeile verwendet (die Zeile, in der die Textfunktion enthalten ist). Textfunktionen wie CellValue() und CellText() funktionieren ähnlich. Wenn die Textfunktion DateOffset in einem Textobjekt enthalten ist, ist der Parameter row-reference erforderlich. Die Zeilenreferenz kann eine Verschiebung enthalten. (Beispiel: Der Wert 1(5) für row-reference gibt den Attributwert für das 5. Tupel in Zeile 1 zurück.) Die referenzierte Spalte muss einen Datums- oder Zeitstempelwert in der Datenquelle referenzieren. Andernfalls wird eine leere Zeichenfolge zurückgegeben.
col-reference - Dieser Parameter ist optional. Wenn der Parameter col-reference nicht angegeben ist, wird die aktuelle Spalte verwendet (die Spalte, in der die Textfunktion enthalten ist). Textfunktionen wie CellValue() und CellText() funktionieren ähnlich. Wenn die Textfunktion DateOffset in einem Textobjekt enthalten ist, ist der Parameter col-reference erforderlich. Die Spaltenreferenz kann eine Verschiebung enthalten. (Beispiel: Der Wert C(E) referenziert den 5. Attributnamen in Spalte C.) Die referenzierte Spalte muss einen Datums- oder Zeitstempelwert in der Datenquelle referenzieren. Andernfalls wird eine leere Zeichenfolge zurückgegeben.
calendar-unit - Die Kalendereinheit ist ein erforderlicher Parameter. Er kann als Jahr, Monat oder Tag angegeben werden und bestimmt, in welcher Maßeinheit die Datumsdifferenz berechnet wird.
offsetAmount - Der Verschiebungsbetrag ist ein erforderlicher Parameter und muss eine positive oder negative Ganzzahl (ungleich null) sein. Wenn der Verschiebungsbetrag positiv ist, muss ihm ein Pluszeichen "+" vorangestellt werden (Beispiel: +3).
Note:
Wenn entweder die Zeilen- oder die Spaltenreferenz einen nicht datumsbezogenen Wert referenziert, gibt die Funktion eine leere Zeichenfolge zurück.
Wenn die Funktion DateOffset() eine Spalte/Zelle referenziert, die kein Datum enthält, erfolgt keine weitere Validierung. In diesem Fall gibt die Funktion eine leere Zeichenfolge zurück.
Gemäß Parameterbeschreibung muss dem Verschiebungsbetrag ein Pluszeichen "+" vorangestellt werden, wenn es sich um eine positive Zahl handelt. Wenn weder ein Plus- noch ein Minuszeichen angegeben ist, tritt ein Syntaxfehler auf. Dieses Verhalten ist erforderlich, damit die Zeichenfolge der Textfunktion korrekt geparst werden kann.
Beispiel
Wenn der Datumswert in der referenzierten Spalte B der 21. Juli 2023 ist, werden folgende Werte zurückgegeben: