<< Click to Display Table of Contents >> Navigation: Anwendungen (Apps) erstellen und ändern - Berechtigung Designer > Features und Funktionen > Textersetzungsklasse > Datum und Zeit |
Ein Platzhalter aus dem Bereich Datum und Zeit liefert einen Rückgabewert auf Basis von Datum und/oder Uhrzeit. Es wird ein Wert zurückgegeben, der dem aktuellen Datum oder der aktuellen Zeit auf dem betreffenden Rechner entspricht (lokale Systemzeit). Bei Terminal/REMOTE-Systemen oder webbasierten Applikationen wird die Systemzeit des Servers verwendet. Berechnung und Formatierung der Rückgabewerte erfolgt nach ISO 8601.
In allen folgenden Beispielen wird als Tagesdatum der 24.01.2000 um 11:30:23 angenommen.
Datums- und Zeit-Variablen |
Erklärung |
Beispiel |
---|---|---|
IsoDate |
Tagesdatum im Format YYYY-MM-DD. |
2000-01-24 |
IsoTime |
Uhrzeit im Format HH:NN:SS. |
11:30:23 |
IsoDateTime |
Tagesdatum und Uhrzeit im Format YYYY-MM-DDTHH:NN:SS. |
2000-01-24T11:30:23 |
FirstDayOfYear |
Erster Tag des aktuellen Jahres im Format YYYY-MM-DD. |
2000-01-01 |
LastDayOfYear |
Letzter Tag des aktuellen Jahres. |
2000-12-31 |
FirstDayOfQuarter |
Erster Tag des aktuellen Quartals. |
2000-01-01 |
LastDayOfQuarter |
Letzter Tag des aktuellen Quartals. |
2000-03-31 |
FirstDayOfMonth |
Erster Tag des aktuellen Monats. |
2000-01-01 |
LastDayOfMonth |
Letzter Tag des aktuellen Monats. |
2000-01-31 |
FirstDayOfWeek |
Erster Tag der aktuellen Woche. |
2000-01-22 |
LastDayOfWeek |
Letzter Tag der aktuellen Woche. |
2000-01-27 |
YYYY |
Jahr (vierstellig). |
2011 |
YY |
Jahr (zweistellig). |
11 |
MM |
Monat (zweistellig). |
01 |
DD |
Tag (zweistellig). |
24 |
HH |
Stunde (zweistellig, 24h Format). |
11 |
NN |
Minute (zweistellig). |
30 |
SS |
Sekunde (zweistellig). |
23 |
ZZ |
Millisekunde (dreistellig). |
100 |
Anzeige des aktuellen Quartals - (einstellig) 1-4. |
01 |
|
WW |
Kalenderwoche (zweistellig). |
04 |
WD |
Tag der Woche, 1 = Montag, 2 = Dienstag ... 7 = Sonntag. |
1 |
YD |
Tag n des aktuellen Jahres (1-365 oder 366, je nach Schaltjahr). |
24 |
Modifikation der Rückgabewerte durch optionale Offset-Parameter
Für die Platzhalter FIRSTDAYOFxx, LASTDAYOFxx und ISODATE gibt es die Möglichkeit, einen Rückgabewert durch Offset-Parametern so zu modifizieren, so dass dieser Wert um eine gewisse Anzahl von Einheiten verschoben wird. Parameter können dabei auch kaskadisch kombiniert werden. Die Berechnung des Rückgabewerts erfolgt von links nach rechts sukzessiv, d.h. zunächst wird der Basiswert ermittelt, für jeden folgenden Offset-Parameter wird dann vom Ergebnis der letzten Berechnung ausgegangen, bevor erneut gerechnet wird.
Offset-Parameter
Durch einen Offset-Parameter [+1D] als Suffix, kann beispielsweise zu dem Rückgabewert ein weiterer Tag addiert, durch [-1M] kann 1 Monat subtrahiert werden. Durch Angabe des Wochentags ist eine Verschiebung auf einen bestimmten vorigen oder nächsten Wochentag möglich, optional auch dann, wenn der errechnete Wert bereits ein solcher Tag ist. Alle Offset-Parameter sind in ein gemeinsames Paar aus eckigen Klammern innerhalb der $$-Delimiter zu setzen.
Variablen für Offset-Parameter |
Mögliche Präfixe |
Hinweis zur Schreibweise |
Funktion |
---|---|---|---|
Y |
+ / - sowie eine ganze Zahl |
[+1Y] |
+/- n Jahr(e) |
Q |
+ / - sowie eine ganze Zahl |
[+1Q] |
+/- n Quartal(e) |
M |
+ / - sowie eine ganze Zahl |
[+1M] |
+/- n Monat(e) |
W |
+ / - sowie eine ganze Zahl |
[+1W] |
+/- n Woche(n) |
D |
+ / - sowie eine ganze Zahl |
[+1D] |
+/- n Tag(n) |
Monday |
+ / ++ / - / -- sowie der Wochentag |
[+Monday] |
Verschiebung auf Wochentag |
Tuesday |
+ / ++ / - / -- sowie der Wochentag |
[+Tuesday] |
Verschiebung auf Wochentag |
Wednesday |
+ / ++ / - / -- sowie der Wochentag |
[+Wednesday] |
Verschiebung auf Wochentag |
Thursday |
+ / ++ / - / -- sowie der Wochentag |
[+Thursday] |
Verschiebung auf Wochentag |
Friday |
+ / ++ / - / -- sowie der Wochentag |
[+Friday] |
Verschiebung auf Wochentag |
Saturday |
+ / ++ / - / -- sowie der Wochentag |
[+Saturday] |
Verschiebung auf Wochentag |
Sunday |
+ / ++ / - / -- sowie der Wochentag |
[+Sunday] |
Verschiebung auf Wochentag |
Anwendungsbeispiele für Offset-Parameter
Variable |
Basiswert |
Offset-Parameter |
Schreibweise |
Ergebnis |
Erklärung |
---|---|---|---|---|---|
IsoDate |
2000-01-24 |
[+1M] |
$$IsoDate[+1M]$$ |
2000-02-24 |
Aktueller Tag + 1 Monat |
LastDayOfMonth |
2000-12-31 |
[+1M] |
$$LastDayOfMonth[+1M]$$ |
2000-02-28 |
Letzter Tag des nächsten Monats |
FirstDayOfMonth |
2000-01-01 |
[+1W] |
$$FirstDayOfMonth[+1W]$$ |
2000-01-08 |
Erster Tag des Monats + 1 Woche |
IsoDate |
2000-01-24 |
[+1W-1D] |
$$IsoDate[+1W-1D]$$ |
2000-01-07 |
Aktueller Tag + 1 Woche - 1 Tag |
FirstDayOfMonth |
2000-01-01 |
[-1M+1D] |
$$LastDayOfMonth[+1M+1D]$$ |
1999-12-02 |
Erster Tag des Monats + 1 Woche + 1 Tag |
IsoDate |
2000-01-24 |
[-Monday] |
$$IsoDate[-Monday]$$ |
2000-01-24 |
Montag vor oder am 24.01.2000 = 24.01.2000 |
IsoDate |
2000-01-24 |
[--Monday] |
$$IsoDate[--Monday}$$ |
2000-01-17 |
Montag vor dem 24.01.2000 = 17.01.2000 |
Anwendungsbeispiele aus der Praxis
Bereich |
Text der im DataNAUT hinterlegt ist |
Text / Code auf Basis von o.a. Datum/Uhrzeit zur Laufzeit |
---|---|---|
SQL |
SELECT * FROM auftraege WHERE datum = '$$IsoDate$$[-1M]' |
SELECT * FROM auftraege WHERE datum <= '1999-12-24' |
Dateiname |
D:\Daten\DateiName$$HH$$$$NN$$$$SS$$.TXT |
D:\Daten\DateiName113023.TXT |
-Param[GESTERN]=$$IsoDate[-1D]$$ |
-Param[GESTERN]=2000-01-23 |