Symbol-Funktion !D, ?D (Datum)

Mit der Symbol-Funktion D (Datum) können Sie Datumsangaben in generierter JCL variabel gestalten. Diese Funktion berechnet Datumswerte, ausgehend vom aktuellen Datum.

Dieser Abschnitt behandelt folgende Themen:


Syntax

§!D<type|period|offset[|offset-unit][,edit-mask][,calendar]>

(für alle Typen außer T)

oder

§!D<T[,edit-mask]>

oder

§!D<yyyymmdd,edit-mask>

Beispiele

§!D<AC-1>

Das Datum vor dem aktuellen Datum (gestern) holen. Das Datum wird im Standard-Format YYYYMMDD zurückgegeben.

§?D<CW+1,DDMMYY>

Den ersten Tag (Montag) der aktuellen Woche im Format DDMMYY holen.

§!D<T,YYMMDD>

Das aktuelle Datum im Format YYMMDD holen.

§!D<20081117,05>

Das Datum 2008-11-17 im Format 05 (DD.MM.YY) holen. Siehe Ausgabedatums-Formate.

§!D<A1+1,MM>

Den vorigen Monat im Format MM (nur Monat) holen.

§!D<A1+1,YYYYMMDD>

Den ersten Tag des vorigen Monats holen.

§!D<A1-1,YYYYMMDD>

Den letzten Tag des vorigen Monats holen.

Funktion

Berechnung von Datumswerten, ausgehend vom aktuellen Datum.

Rückgabeformat

Siehe Ausgabe-Datumsformate.

Parameter

Die Parameter werden ohne Trennzeichen direkt aneinandergefügt.

Syntax-Element Parameter Erklärung
type Typ
T Aktuelles Tagesdatum (heute).

Anmerkung:
Für diesen Typ sind die Parameter period, offset und offset-unit nicht erforderlich und werden nicht ausgewertet.

A Alle Tage (365 bzw. 366 Tage im Jahr).
C Kalender-Tage (Tage, die im Kalender als Werktage definiert sind).
S Zeitplan-Tage.
period Zeitraum (nicht ausgewertet bei Typ T).
C Ab aktuellem Tag.
W Woche.
M Monat.
1...9  Ein Monat zurück ... 9 Monate zurück.
Q Quartal.
Y Jahr.
offset Versatz (positive oder negative Zahl mit Vorzeichen).
offset-unit Einheit für den Versatz - optional, wird nur für Typ A (alle Tage) ausgewertet.
D Tage (Standardwert).
W Wochen.
M Monate.
Q Quartale.
Y Jahre.
calendar Kalender. Siehe Bezugsobjekte, Kalender.
yyyymmdd Datum. Format YYYYMMDD.

Bezugsobjekte

Syntax-Element Bedeutung
Kalender Falls ein Kalender explizit angegeben wurde, so wird dieser für Kalenderberechnungen herangezogen. Dieser Kalender muss unter dem aktuellen Eigentümer existieren. Falls er dort nicht gefunden wird, so wird er unter dem Eigentümer SYSDBA gesucht. Andernfalls wird der dem aktuellen Zeitplan zugeordnete Kalender verwendet. Wenn kein Kalender definiert wurde, so gelten alle Tage als Werktage.
Unternetzwerk-Überlegungen:
  • Wenn Sie die Symbol-Funktion aus einem Unternetzwerk aufrufen, wird der Zeitplan und Kalender der obersten Hierarchie (aufgerufenes Hauptnetzwerk) für die Zeitplan- und Kalenderberechnung genutzt.

  • Zeitpläne oder Kalender, die in einem Unternetzwerk genutzt werden, werden bei diesen Berechnungen nicht beachtet.

  • Es ist nicht notwendig, Zeitpläne oder Kalender zu definieren, die nur für Unternetzwerke genutzt werden, da diese nicht relevant sind.

Wenn dieser Parameter fehlt, oder wenn ein unbekanntes Format verwendet worden ist, wird das Datum im Format YYYYMMDD (Beispiel: 19991117) zurückgegeben.

Ausgabedatums-Formate

Die hier beschriebenen Ausgabedatums-Formate können für die Symbolfunktionen D und W.** verwendet werden.

Das standardmäßige Datumsausgabe-Format ist YYYYMMDD (z.B. 20081117).

Format Numerisches Äquivalent Beispiel
DD  01  17 
DDMM  02  1711 
DDMMYY  03  171108 
DDMMYYYY  04  17112008 
DD.MM.YY

DD#MM#YY

 
05  17.11.08 
DD.MM.YYYY

DD#MM#YYYY

 
06  17.11.2008 
DD/MM/YY  07  17/11/08 
DD/MM/YYYY  08  17/11/2008 
DD-MM-YY  09  17-11-08
DD-MM-YYYY  10  17-11-2008 
JJJ  38  330 
JJJYY  39  33008 
JJJYYYY  40  3302008 
MM  11  11 
MMDD  12  1117 
MMDDYY  35  111708 
MMYY  13  1108
MM.YY

MM#YY 

14  11.08 
MMYYYY  15  112008 
MM.YYYY

MM#YYYY

 
16  11.2008 
MM/DD/YY  36  11/17/08 
MM-DD-YY  37  11-17-08 
NN  17  Sa (Erste 2 Zeichen des Wochentag-Namens).

Dieser Wert ist von der aktuellen Sprach-Einstellung der Natural-Sitzung abhängig.)

18  6 (Wochentagszahl).

Dieser Wert ist vom Natural-Profilparameter DTFORM der Natural-Sitzung abhängig. Einzelheiten siehe Natural-Dokumentation.)

QQ  34  SA (wie das Format NN, aber in Großbuchstaben.)
WW  19  47 (Wochenzahl)
WWYY  41  4708 (Woche und Jahr)
WWYYYY  42  472008 (Woche und Jahr)
YY  20  08 
YYJJJ  21  08330 
YYMM  22  0811 
YYMMDD  23  081117 
YYWW  43  0847 (Jahr und Woche)
YYYY  24  2008 
YYYYJJJ  25  2008330 
YYYYMM  26  200811 (Jahr und Monat)
YYYYMMDD  27  20081117 
YYYYWW  44  200847 (Jahr und Woche)
YYYY.MM.DD

YYYY#MM#DD

 
28  2008.11.17 
YYYY/MM/DD  29  2008/11/17 
YYYY-MM-DD  30  2008-11-17 
YY.MM

YY#MM

 
45  08.11 
YY.MM.DD

YY#MM#DD

 
31  08.11.17 
YY/MM/DD  32  08/11/17 
YY-MM-DD  33  08-11-17