Extraktionsfunktionen

Die Extraktionsfunktionen extrahieren Unterfelder aus Datums-oder Zeitintervallen, die auf den Tag oder eine Uhrzeit aus einem Datumswert abzielen. Dadurch können Sie Ereignisse nach Wochentag, Saison, Schicht usw. klassifizieren.

Jede Extraktionsfunktion beginnt mit XDATE, gefolgt von einem Punkt, dem Namen der Unterfunktion (was Sie extrahieren wollen) und einem Argument.

XDATE.DATE. XDATE.DATE(datum). Numerisch. Ergibt den Datumsteil aus einem numerischen Wert, der ein Datum darstellt. Das Argument kann eine Zahl, eine Variable im Datumsformat oder ein Ausdruck sein, der ein Datum ergibt. Um das Ergebnis als Datum anzuzeigen, muss der Variablen ein Datumsformat zugewiesen werden.

XDATE.HOUR. XDATE.HOUR(datum/zeit). Numerisch. Ergibt die Stunde (eine ganze Zahl zwischen 0 und 23) aus einem Wert, der eine Zeitangabe oder ein Datum darstellt. Das Argument kann eine Zahl sein, eine Zeit- oder Datumsvariable oder ein Ausdruck, der einen Zeit- oder Datumswert ergibt.

XDATE.JDAY. XDATE.JDAY(datum). Numerisch. Ergibt den Tag des Jahres (eine ganze Zahl zwischen 1 und 366) aus einem numerischen Wert, der ein Datum darstellt. Das Argument kann eine Zahl, eine Variable im Datumsformat oder ein Ausdruck sein, der ein Datum ergibt.

XDATE.MDAY. XDATE.MDAY(datum). Numerisch. Ergibt den Tag des Monats (eine ganze Zahl zwischen 1 und 31) aus einem numerischen Wert, der ein Datum darstellt. Das Argument kann eine Zahl, eine Variable im Datumsformat oder ein Ausdruck sein, der ein Datum ergibt.

XDATE.MINUTE. XDATE.MINUTE(datum/zeit). Numerisch. Ergibt die Minute (eine ganze Zahl zwischen 0 und 59) aus einem Wert, der eine Zeitangabe oder ein Datum darstellt. Das Argument kann eine Zahl sein, eine Zeit- oder Datumsvariable oder ein Ausdruck, der einen Zeit- oder Datumswert ergibt.

XDATE.MONTH. XDATE.MONTH(datum). Numerisch. Ergibt den Monat (eine ganze Zahl zwischen 1 und 12) aus einem numerischen Wert, der ein Datum darstellt. Das Argument kann eine Zahl, eine Variable im Datumsformat oder ein Ausdruck sein, der ein Datum ergibt.

XDATE.QUARTER. XDATE.QUARTER(datum). Numerisch. Ergibt das Quartal des Jahres (eine ganze Zahl zwischen 1 und 4) aus einem numerischen Wert, der ein Datum darstellt. Das Argument kann eine Zahl, eine Variable im Datumsformat oder ein Ausdruck sein, der ein Datum ergibt.

XDATE.SECOND. XDATE.SECOND(datum/zeit). Numerisch. Ergibt die Sekunde (eine ganze Zahl zwischen 0 und 60) aus einem Wert, der eine Zeitangabe oder ein Datum darstellt. Das Argument kann eine Zahl sein, eine Zeit- oder Datumsvariable oder ein Ausdruck, der einen Zeit- oder Datumswert ergibt.

XDATE.TDAY. XDATE.TDAY(zeit). Numerisch. Ergibt die Anzahl der ganzen Tage (als ganze Zahl) aus einem numerischen Wert, der einen Zeitraum darstellt. Das Argument kann eine Zahl, eine Variable im Zeitformat oder ein Ausdruck sein, der einen Zeitraum ergibt.

XDATE.TIME. XDATE.TIME(datum/zeit). Numerisch. Ergibt die Zeitangabe aus einem Wert, der eine Zeitangabe oder ein Datum darstellt. Das Argument kann eine Zahl sein, eine Zeit- oder Datumsvariable oder ein Ausdruck, der einen Zeit- oder Datumswert ergibt. Um das Ergebnis als Zeit anzuzeigen, muss der Variablen ein Zeitformat zugewiesen werden.

XDATE.WEEK. XDATE.WEEK(datum). Numerisch. Ergibt die Woche (eine ganze Zahl zwischen 1 und 53) aus einem numerischen Wert, der ein Datum darstellt. Das Argument kann eine Zahl, eine Variable im Datumsformat oder ein Ausdruck sein, der ein Datum ergibt.

XDATE.WKDAY. XDATE.WKDAY(datum). Numerisch. Ergibt den Wochentag (eine ganze Zahl zwischen 1 für Sonntag und 7 für Samstag) aus einem numerischen Wert, der ein Datum darstellt. Das Argument kann eine Zahl, eine Variable im Datumsformat oder ein Ausdruck sein, der ein Datum ergibt.

XDATE.YEAR. XDATE.YEAR(datum). Numerisch. Ergibt das Jahr (als vierstellige ganze Zahl) aus einem numerischen Wert, der ein Datum darstellt. Das Argument kann eine Zahl, eine Variable im Datumsformat oder ein Ausdruck sein, der ein Datum ergibt.

Beispiel

DATA LIST FREE (",") 
  /StartDateTime (datetime25).
BEGIN DATA
29-OCT-2003 11:23:02
1 January 1998 1:45:01
21/6/2000 2:55:13
END DATA.
COMPUTE dateonly=XDATE.DATE(StartDateTime).
FORMATS dateonly(ADATE10).
COMPUTE hour=XDATE.HOUR(StartDateTime).
COMPUTE DayofWeek=XDATE.WKDAY(StartDateTime).
COMPUTE WeekofYear=XDATE.WEEK(StartDateTime).
COMPUTE quarter=XDATE.QUARTER(StartDateTime).

• Der mit XDATE.DATE extrahierte Datumsteil gibt ein Datum in Sekunden zurück. Daher wird FORMATS verwendet, um das Datum in einem lesbaren Datumsformat anzuzeigen.
• Der Wochentag ist eine ganze Zahl zwischen 1 (Sonntag) und 7 (Samstag).
• Die Woche des Jahres ist eine ganze Zahl zwischen 1 und 53 (1. bis 1. Januar).