Janosch's Funktionssammlung

Name

Date

Syntax

datum = Date( [option][, convDate[, convOpt]][, osep][, isep] ) [;]

Beschreibung

Liefert aktuelles Datum im von der angegebenen Option abhängigen Format zurück oder wandelt das angegebene Datum von einem Format in ein anderes um. Folgende Formate werden unterstützt (Erklärung in Bemerkungen):

Option

Format

dddddd

ddd

dd/mm/yy

ddjjj (nur Mainframe)

uuuuuuuuuuuuuuuuuu

dd month yyyy

Month

dd mon yyyy

yy/mm/dd

yyyymmdd

ssssssssssss

mm/dd/yy

Weekday

Aufrufparameter

Parameter

Beschreibung

option

Beschreibt das Ausgabeformat des Datums.

convDate

Das Datum, das vom Format convOpt in das Format option konvertiert verden soll.

convOpt

Format des Datums abhängig von der Angabe im Parameter convDate.

osep

Ausgabeseparator. Der Separator, der im Ausgabedatum den Standardseparator für das über den Parameter option festgelegte Format, ersetzen soll. Eingabe dieses Parameters ist nicht für z/OS implementiert.

isep

Eingabeseparator. Der Separator, der im Eingabedatum convDate an Stelle des Standardseparators angegeban wurde. Eingabe dieses Parameters ist nicht für z/OS implementiert.

Standardwerte

Parameter

Wert

option

convOpt

Rückgabewerte

Name/Wert

Bedeutung

datum

Datum im Format das vom Parameter option abhängig ist..

Bemerkungen

Parameter osep und isep sind nicht für REXX unter z/OS implementiert.

Nur der erste Buchstabe des Optionsnamen wird interpretiert, Die Groß- Kleinschreibung hat keine Bedeutung. Folgende Optionen für option und convOptdürfen verwendet werden:

Base. dddddd - Anzahl der Tage seit 01.01.0001

Days. ddd - Anzahl der Tage seit Jahresanfang (01.01. dieses Jahres)

European. dd/mm/yy

Julian. ddjjj - Datum im julianischen Format mit der vorangestellten 2-stelligen Jahresangabe - nur Mainframe.

Full. uuuuuuuuuuuuuuuuuu - die Anzahl von Mikrosekunden seit 00:00:00.000000 am 1. Januar 0001. Ohne führenden Blanks bzw. Nullen. Die Ausgabe kann zur Berechnung von Datumintervalen bzw. Zeitstempeln (Timestamp arithmetic) verwendet werden. Die Option NUMERIC DIGITS muss dann auf mindestens 18 gesetzt werden.

Language. dd month yyyy- Implementationsabhängiges oder lokales Datum. Der Monatsname month ist vom installiertem National Language Support abhängig.

Month. Gibt den vollständigen englischen Namen des aktuellen Monats zurück, z. B.: January

Normal. Gibt das aktuelle Datum im Format dd mon yyyy zurück. Das ist die Standardeinstellung.

Ordered. yy/mm/dd - Ein Format zum Sortieren nach Datum mit der 2-stelligen Jahresangabe.

Standard. yyyymmdd - Ein Format zum Sortieren nach Datum mit der 4-stelligen Jahresangabe und ohne Separatoren.

Ticks. ssssssssssss - die Anzahl von Sekunden seit 00:00:00.000000 am 1. Januar 1970. Ohne führenden Blanks bzw. Nullen. Die Ausgabe kann zur Berechnung von Datumintervalen bzw. Zeitstempeln (Timestamp arithmetic) verwendet werden. Die Option NUMERIC DIGITS muss dann auf mindestens 12 gesetzt werden.
Die Funktion liefert negative Zahlen für Datumsangaben vor dem 1. Januar 1970.

USA. mm/dd/yy - Das US-Amerikanische-Format mit der 2-stelligen Jahresangabe.

Weekday. Gibt den vollständigen englischen Namen des aktuellen Wochentags (der 1. Buchstabe großgeschrieben) zurück, z. B.: Thursday

Die optionalen Konvertierungsparameter (convDate und convOpt) erlauben es, ein Datum (convDate) vom Format convOpt in das Datum im Format, das durch die option festgelegt wurde, umzuwandeln (siehe Beispiel 3).

Nicht für alle Kombinationen wird die Umstellung durchgeführt. Wählt man nicht erlaubte bzw. falsche Optionen, so wird das Return Code (RC) 40 zurück gegeben.

Bei der Konvertierung vom Format J in die Formate, die das Jahr 4-stellig darstellen, wird folgende Regel verwendet:
Wenn jj < 56, dann: jjjj = 2000 + jj, sonst: jjjj = 1900 + jj

Beispiel 1

string = Date()
Say string

Ergebnis 1

28 Aug 2008

Beispiel 2

string = Date( "B" )
Say string

Ergebnis 2

Beispiel 3

option = "N"
convDate = "20080531"
convOpt = "S"
string = Date( option, convDate, convOpt )
Say string

Ergebnis 3

31 May 2008

Beispiel 4

option = "O"           /* Ausgabeformat: yy/mm/dd      */
convDate = "20080531"  /* Datum zum Knvertieren        */
convOpt = "S"          /* Format zum Konvertieren      */
osep = "."             /* Separatorzeichen der Ausgabe */
string = Date( option, convDate, convOpt, osep )
Say string

Ergebnis 4

08.05.31

Beispiel 5

option = "O"      /* Ausgabeformat: yy/mm/dd      */
osep = "-"        /* Separatorzeichen der Ausgabe */
string = Date( option,,, osep )
Say string

Ergebnis 5

08-08-28

Your privacy: This web site has no cookies, no advertising and does not provide access data to anyone for any reason.
Copyright © Janosch R. Kowalczyk 1999, 2010. All rights reserved.
Most recent revision on 24 Aug 2010 (236) - 14:48:57.