Datums- und Zeitfunktionen ( DataStage® )

Mit den Datums- und Zeitfunktionen können Sie verschiedene Operationen für Datums- und Zeitangaben in der Transformer-Stage ausführen.

Funktionen, die Datums-, Zeitangaben- oder Zeitmarken in den Argumenten angeben, verwenden Zeichenfolgen mit bestimmten Formaten:
  • Für ein Datum ist das Format%jjjj-%Mm-%TT
  • Für eine Zeit lautet das Format%HH:%Nn:%ss. Wenn die Erweiterung auf Mikrosekunden erweitert wird, lautet das Format %HH:%Nn:%SS.X , wobei X die Anzahl der Dezimalstellen angibt, für die Sekunden angegeben werden.
  • Für eine Zeitmarke ist das Format das Datumsformat, gefolgt von dem Zeitformat.

Funktionen, die die Wochentage im Argument haben, nehmen eine Zeichenfolge mit dem Tag der Woche an. Der Tag wird als Abkürzung mit drei Buchstaben oder als vollständiger Name angegeben. Beispielsweise sind die Zeichenfolgen "thu" und "thursday" beide gültig.

Die folgenden Funktionen befinden sich in der Kategorie Datum & Zeit des Ausdruckseditors. Klammern zeigen an, dass ein Argument optional ist. Die Beispiele zeigen die Funktion so, wie sie in einem Ableitungs-Feld in der Transformer-Stage angezeigt wird.
CurrentDate
Gibt das Datum zurück, an dem der Job ausgeführt wird.
  • Eingabe: Nicht zutreffend
  • Ausgabe: Datum (Datum)
  • Beispiele. Verwenden Sie diese Funktion, um eine neue Spalte hinzuzufügen, die das Datum für die Ausgabedaten nach der Stage 'Transformer' enthält:
    CurrentDate()
CurrentTime
Gibt die aktuelle Systemzeit zurück.
  • Eingabe: Nicht zutreffend
  • Ausgabe: Zeit (Zeit)
  • Beispiele. Fügen Sie mit dieser Funktion eine neue Spalte hinzu, die die Uhrzeit für die Ausgabedaten nach der Stage 'Transformer' enthält. Wenn Sie das Argument in eckigen Klammern nicht angeben, gibt die Funktion ein Zeitfeld ohne Mikrosekunden zurück.
    CurrentTime()
    Optional: Wenn Sie das Zeichenfolgenargument „support_microsecond“ angeben, gibt die Funktion ein Zeitfeld mit Mikrosekunden zurück.
    CurrentTime("support_microsecond")
CurrentTimeMS
Gibt die aktuelle Systemzeit einschließlich Mikrosekunden zurück.
  • Eingabe: Nicht zutreffend
  • Ausgabe: Zeit (Zeit)
  • Beispiele. Fügen Sie mit dieser Funktion eine neue Spalte hinzu, die die Uhrzeit für die Ausgabedaten nach der Stage 'Transformer' enthält. Sie müssen das Feld Erweitert in den Spaltenmetadaten auf Mikrosekunden setzen, um die Vollzeit aufzunehmen.
    CurrentTimeMS()
CurrentTimestamp
Gibt eine Zeitmarke zurück, die den Zeitpunkt (Datum und Zeit) angibt, an dem der Job ausgeführt wird.
  • Eingabe: Nicht zutreffend
  • Ausgabe: Zeitmarke (Zeitmarke)
  • Beispiele. Fügen Sie mit dieser Funktion eine neue Spalte hinzu, die die Zeitmarke für die Ausgabedaten nach der Stage 'Transformer' enthält:
    CurrentTimestamp()
CurrentTimestampMS
Gibt eine Zeitmarke (einschließlich Mikrosekunden) zurück, die den Zeitpunkt (Datum und Zeit) angibt, an dem der Job ausgeführt wird.
  • Eingabe: Nicht zutreffend
  • Ausgabe: Zeitmarke (Zeitmarke)
  • Beispiele. Fügen Sie mit dieser Funktion eine neue Spalte hinzu, die die Zeitmarke für die Datenausgabe der Stage 'Transformer' enthält. Sie müssen das Feld Erweitert in den Spaltenmetadaten auf Mikrosekunden setzen, um die vollständige Zeitmarke aufzunehmen.
    CurrentTimestampMS()
ConvertTimeZone
Konvertiert eine Zeitmarke mit Zeitzone in eine andere Zeitzone.
  • Eingabe: Jahr der Zeitzone, in die konvertiert werden soll (int), Monat der Zeitzone, in die konvertiert werden soll (int), Tag der Zeitzone, in die konvertiert werden soll (int), Stunde der Zeitzone, in die konvertiert werden soll (int), Minuten der Zeitzone, in die konvertiert werden soll (int), Sekunden der Zeitzone, in die konvertiert werden soll (int), Akronym der Zeitzone mit drei Buchstaben für die Konvertierung (string), Akronym der Zeitzone mit drei Buchstaben für die Konvertierung (string)
  • Ausgabe: neue Zeitzone (Zeichenfolge)
  • Beispiele. Wenn mylink.currentYear die Ganzzahl 2021 enthält, gibt die folgende Funktion eine Zeitmarkenzeichenfolge zurück, die die neue Zeitzone "2021-09-30 04:02:03" verwendet.
    ConvertTimeZone(mylink.currentYear, 9, 30, 1, 2, 3, "PST", "EST")
DateFromDaysSince
Gibt eine Datumszeichenfolge zurück, indem eine ganze Zahl zu einem Referenzdatum addiert wird. Die ganze Zahl kann ein negativer Wert sein, um ein Datum zurückzugeben, das vor dem Referenzdatum liegt. Diese Funktion ist in IBM® InfoSphere® Information Server, Version 11.3, veraltet. Verwenden Sie die Funktion DateFromDaysSince2.
  • Eingabe: Zahl (int32), [baseline_date_string (zeichenfolge)]
  • Ausgabe: Datum (Datum)
  • Beispiele. Wenn 'mylink.myintcol' die Ganzzahl 18250 und 'mylink.mydatecol ' das Datum 1958-08-18 enthält, sind die drei folgenden Funktionen äquivalent und geben das Datum 2008-08-05 zurück:
    DateFromDaysSince(18250,"1958-08-18")
    DateFromDaysSince(mylink.myintcol,"1958-08-18")
    DateFromDaysSince(mylink.myintcol,mylink.mydatecol)
    Wenn mylink.mynegintcol die ganze Zahl -1 und mylink.mydatecol das Datum 1958-08-18 enthält, sind die folgenden drei Funktionen äquivalent und geben das Datum 1958-08-17 zurück:
    DateFromDaysSince(-1,"1958-08-18")
    DateFromDaysSince(mylink.mynegintcol,"1958-08-18")
    DateFromDaysSince(mylink.mynegintcol,mylink.mydatecol)
DateFromDaysSince2
Gibt ein Datumsobjekt zurück, indem eine ganze Zahl zu einem Referenzdatum addiert wird. Die ganze Zahl kann ein negativer Wert sein, um ein Datum zurückzugeben, das vor dem Referenzdatum liegt.
  • Eingabe: Zahl (int32), [baseline_date_object (datum)]
  • Ausgabe: Datum (Datum)
  • Beispiele. Wenn 'mylink.myintcol' die Ganzzahl 18250 und 'mylink.mydatecol ' das Datum 1958-08-18 enthält, sind die drei folgenden Funktionen äquivalent und geben das Datum 2008-08-05 zurück:
    DateFromDaysSince2(18250,"1958-08-18")
    DateFromDaysSince2(mylink.myintcol,"1958-08-18")
    DateFromDaysSince2(mylink.myintcol,mylink.mydatecol)
    Wenn mylink.mynegintcol die ganze Zahl -1 und mylink.mydatecol das Datum 1958-08-18 enthält, sind die folgenden drei Funktionen äquivalent und geben das Datum 1958-08-17 zurück:
    DateFromDaysSince2(-1,"1958-08-18")
    DateFromDaysSince2(mylink.mynegintcol,"1958-08-18")
    DateFromDaysSince2(mylink.mynegintcol,mylink.mydatecol)
DateFromComponents
Gibt ein Datum mit den angegebenen Werten für Jahr, Monat und Tag im Monat zurück, die als drei separate Werte angegeben werden.
  • Eingabe: Jahre (int32), Monate (int32), Tag des Monats (int32)
  • Ausgabe: Datum (Datum)
  • Beispiele. Wenn 'mylink.yearcol' den Wert 2010 enthält, 'mylink.monthcol' den Wert 12 und 'mylink.dayofmonthcol ' den Wert 2, sind die beiden folgenden Funktionen äquivalent und geben das Datum 2010-12-02 zurück.
    DateFromComponents(2010, 12, 2)
    DateFromComponents(mylink.yearcol, mylink.monthcol, mylink.dayofmonthcol)
    
DateFromJulianDay
Gibt ein Datum für die angegebene Tageszahl des julianischen Kalenders zurück.
  • Eingabe: julianday (uint32)
  • Ausgabe: Datum (Datum)
  • Beispiele. Wenn mylink.myjulcol den Wert 2454614 enthält, sind die beiden folgenden Funktionen äquivalent und geben das Datum 2008-05-27 zurück.
    DateFromJulianDay(2454614)
    DateFromJulianDay(mylink.myjulcol)
    
DateOffsetByComponents
Gibt das angegebene Datum mit den angegebenen Offsets für Jahr, Monat und Tag im Monat zurück, die als drei separate Werte angegeben werden. Die Offsetwerte können jeweils positiv, null oder negativ sein.
  • Eingabe: basedate (date), year_offset (int32), month_offset (int32), dayofmonth_offset (int32)
  • Ausgabe: Datum (Datum)
  • Beispiele. Wenn 'mylink.basedate' 2011-08-18 und 'mylink.yearos 'den Wert 2,' mylink.monthos 'den Wert 0 und 'mylink.dayofmonthosol' den Wert 0 enthält, sind die beiden folgenden Funktionen äquivalent und geben das Datum 2013-08-18 zurück.
    DateOffsetByComponents("2011-08-18", 2, 0, 0)
    DateOffsetByComponents(mylink.basedate, mylink.yearos, mylink.monthos, 
    mylink.dayofmonthos)
    
  • Wenn 'mylink.basedate' 2011-08-18 und 'mylink.yearos 'den Wert -2,' mylink.monthos 'den Wert 0 und 'mylink.dayofmonthosol' den Wert 0 enthält, sind die beiden folgenden Funktionen äquivalent und geben das Datum 2009-08-18 zurück:
    DateOffsetByComponents("2011-08-18", -2, 0, 0)
    DateOffsetByComponents(mylink.basedate, mylink.yearos, mylink.monthos, 
    mylink.dayofmonthos)
    
DaysSinceFromDate
Gibt die Anzahl der Tage vom Quellendatum bis zum angegebenen Datum zurück. Diese Funktion ist in IBM InfoSphere Information Server, Version 11.3, veraltet. Verwenden Sie die Funktion DaysSinceFromDate2.
  • Eingabe: given_date (Datum), source_date_string (zeichenfolge)
  • Ausgabe: days_since (int32)
  • Beispiele. Wenn mylink.mysourcedate das Datum 1958-08-18 und mylink.mygivendate das Datum 2008-08-18 enthält, sind die beiden folgenden Funktionen äquivalent und geben den ganzzahligen Wert 18263 zurück.
    DaysSinceFromDate(mylink.mygivendate, mylink.mysourcedate)
    DaysSinceFromDate("2008-08-18","1958-08-18")
    
DaysSinceFromDate2
Gibt die Anzahl der Tage vom Quellendatum bis zum angegebenen Datum zurück.
  • Eingabe: given_date (Datum), source_date_object (Datum)
  • Ausgabe: days_since (int32)
  • Beispiele. Wenn mylink.mysourcedate das Datum 1958-08-18 und mylink.mygivendate das Datum 2008-08-18 enthält, sind die beiden folgenden Funktionen äquivalent und geben den ganzzahligen Wert 18263 zurück.
    DaysSinceFromDate2(mylink.mygivendate, mylink.mysourcedate)
    DaysSinceFromDate2("2008-08-18","1958-08-18")
DaysInMonth
Gibt die Anzahl der Tage im Monat aus dem angegebenen Basisdatum zurück.
  • Eingabe: Basisdatum (Datum)
  • Ausgabe: daysinmonth (int32)
  • Beispiele. Wenn 'mylink.mysourcedate' das Datum 1958-08-18 enthält, sind die beiden folgenden Funktionen äquivalent und geben den ganzzahligen Wert 31 zurück:
    DaysInMonth(mylink.mysourcedate)
    DaysInMonth("1958-08-18")
    
DaysInYear
Gibt die Anzahl der Tage im Jahr aus dem angegebenen Basisdatum zurück.
  • Eingabe: Basisdatum (Datum)
  • Ausgabe: daysinyearh (int32)
  • Beispiele. Wenn mylink.mysourcedate das Datum 2012-08-18 enthält, sind die beiden folgenden Funktionen äquivalent und geben den ganzzahligen Wert 366 zurück.
    DaysInYear(mylink.mysourcedate)
    DaysInYear("2012-08-18")
    
    Wenn mylink.mysourcedate das Datum 2011-08-18 enthält, dann sind die beiden folgenden Funktionen äquivalent und geben den ganzzahligen Wert 365 zurück.
    DaysInYear(mylink.mysourcedate)
    DaysInYear("2011-08-18")
    
DateOffsetByDays
Gibt den angegebenen Datumsoffset mit der angegebenen Anzahl von Tagen zurück. Der Offsetwert kann positiv, null oder negativ sein.
  • Eingabe: basedate (Datum), dayoffset (int32)
  • Ausgabe: Datum (Datum)
  • Beispiele. Wenn mylink.basedate 2011-08-18 und mylink.dayoffset den Wert 2 enthält, sind die beiden folgenden Funktionen äquivalent und geben das Datum 2011-08-20 zurück.
    DateOffsetByDays("2011-08-18", 2)
    DateOffsetByDays(mylink.basedate, mylink.dayoffset)
    
  • Wenn mylink.basedate den Wert 2011-08-18 und mylink.dayoffset den Wert -31 enthält, sind die beiden folgenden Funktionen äquivalent und geben das Datum 2011-07-18 zurück.
    DateOffsetByDays("2011-08-18", -31)
    DateOffsetByDays(mylink.basedate, mylink.dayoffset)
    
HoursFromTime
Gibt die Stunden aus einer Zeitangabe zurück.
  • Eingabe: Zeit (Zeit)
  • Ausgabe: Stunden (int8)
  • Beispiele. Wenn 'mylink.mytime' die Uhrzeit 22:30:00 enthält, sind die beiden folgenden Funktionen äquivalent und geben den ganzzahligen Wert 22 zurück:
    HoursFromTime(mylink.mytime)
    HoursFromTime("22:30:00")
    
JulianDayFromDate
Gibt die Tageszahl des julianischen Kalenders für das angegebene Datum zurück.
  • Eingabe: Datum (Datum)
  • Ausgabe: julianday (int32)
  • Beispiele. Wenn mylink.mydate das Datum 2008-05-27 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 2454614 zurück.
    JulianDayFromDate("2008–05–27")
    JulianDayFromDate(mylink.mydate)
    
MicroSecondsFromTime
Gibt die Mikrosekunden aus einer Zeitangabe zurück.
  • Eingabe: Zeit (Zeit)
  • Ausgabe: Mikrosekunden (int32)
  • Beispiele. Wenn mylink.mytime die Zeit 22:30:00.32 enthält, gibt die folgende Funktion den Wert 320000 zurück:
    MicroSecondsFromTime(mylink.mytime)
    
MidnightSecondsFromTime
Gibt die Anzahl der Sekunden von Mitternacht bis zur angegebenen Uhrzeit zurück.
  • Eingabe: Zeit (Zeit)
  • Ausgabe: Sekunden (int8)
  • Beispiele. Wenn 'mylink.mytime' die Zeit 00:30:52 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 1852 zurück:
    MidnightSecondsFromTime("00:30:52")
    MidnightSecondsFromTime(mylink.mytime)
    
MinutesFromTime
Gibt die Minuten aus einer Zeitangabe zurück.
  • Eingabe: Zeit (Zeit)
  • Ausgabe: Minuten (int8)
  • Beispiele. Wenn mylink.mytime die Zeit 22:30:52 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 30 zurück:
    MinutesFromTime("22:30:52")
    MinutesFromTime(mylink.mytime)
    
MonthDayFromDate
Gibt den Tag im Monat für das angegebene Datum zurück.
  • Eingabe: Datum (Datum)
  • Ausgabe: Tag (int8)
  • Beispiele. Wenn mylink.mydate das Datum 2008-08-18 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 18 zurück.
    MonthDayFromDate("2008-08-18")
    MonthDayFromDate(mylink.mydate)
    
MonthFromDate
Gibt die Monatszahl für das angegebene Datum zurück.
  • Eingabe: Datum (Datum)
  • Ausgabe: month_number (int8)
  • Beispiele. Wenn mylink.mydate das Datum 2008-08-18 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 8 zurück:
    MonthFromDate("2008-08-18")
    MonthDayDate(mylink.mydate)
    
NextWeekdayFromDate
Gibt das Datum des angegebenen Wochentags zurück, der als nächstes auf das Quellendatum folgt. Der Wochentag wird als vollständiger Name (z. B. thursday für Donnerstag) oder als aus drei Buchstaben bestehende Abkürzung (z. B. thu) angegeben.
  • Eingabe: sourcedate (Datum), day_of_week (Zeichenfolge)
  • Ausgabe: Datum (Datum)
  • Beispiele. Wenn mylink.mysourcedate das Datum 2008-08-18 enthält und der angegebene Wochentag Donnerstag ist, sind die beiden folgenden Funktionen äquivalent und geben den Wert 2008-08-21 zurück:
    NextWeekdayFromDate("2008-08-18", "thursday")
    NextWeekdayFromDate(mylink.mysourcedate, "thu")
    
NthWeekdayFromDate
Gibt das Datum des angegebenen Wochentags mit Offset um die angegebene Anzahl Wochen ab dem Quellendatum zurück. Der Wochentag wird als vollständiger Name (z. B. thursday für Donnerstag) oder als aus drei Buchstaben bestehende Abkürzung (z. B. thu) angegeben. Die Offsetwerte können positiv, negativ oder null sein.
  • Eingabe: basedate (Datum), day_of_week (Zeichenfolge), week_offset (int32)
  • Ausgabe: Datum (Datum)
  • Beispiele. Wenn das Datum mylink.mydate 2009-08-18 enthält und Donnerstag mit einem Offset von 1 angegeben ist, dann sind die beiden folgenden Funktionen gleichwertig und geben den Wert 2009–08–20 zurück:
    NthWeekdayFromDate("2009-08-18", "thursday", 1)
    NthWeekdayFromDate(mylink.mydate, "thu", 1)
    
    Das erste Vorkommen von Donnerstag wird zurückgegeben. Im folgenden Beispiel kommt 'Thursday' in derselben Woche wie das Datum 2009-08-18 vor. Das Datum 2009-08-18 ist ein Dienstag (Tuesday).
    Wenn mylink.mydate das Datum 2009-08-18 enthält und Donnerstag mit einem Offset von -2 angegeben wird, sind die beiden folgenden Funktionen äquivalent und geben den Wert 2009-08-06 zurück:
    NthWeekdayFromDate("2009-08-18", "thursday", -2)
    NthWeekdayFromDate(mylink.mydate, "thu", -2)
    
    Das Vorkommen von Donnerstag, der zwei Donnerstage zurückliegt, wird zurückgegeben.
PreviousWeekdayFromDate
Gibt das Datum des angegebenen Wochentags zurück, der als nächstes vor dem Quellendatum liegt. Der Wochentag wird als vollständiger Name (z. B. thursday für Donnerstag) oder als aus drei Buchstaben bestehende Abkürzung (z. B. thu) angegeben.
  • Eingabe: sourcedate (Datum), day_of_week (Zeichenfolge)
  • Ausgabe: Datum (Datum)
  • Beispiele. Wenn mylink.mysourcedate das Datum 2008-08-18 enthält und Donnerstag angegeben ist, sind die beiden folgenden Funktionen äquivalent und geben den Wert 2008-08-14 zurück:
    PreviousWeekdayFromDate("2008-08-18", "thursday")
    PreviousWeekdayFromDate(mylink.mysourcedate, "thu")
    
SecondsFromTime
Gibt die Sekunden aus einer Zeitangabe zurück.
  • Eingabe: Zeit (Zeit)
  • Ausgabe: Sekunden (dfloat)
  • Beispiele. Wenn 'mylink.mytime' die Zeit 22:30:52 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 52 zurück:
    SecondsFromTime("22:30:52")
    SecondsFromTime(mylink.mytime)
    
SecondsSinceFromTimestamp
Gibt die Anzahl der Sekunden zwischen zwei Zeitmarkenzeichenfolgen zurück. Diese Funktion ist in IBM InfoSphere Information Server, Version 11.3, veraltet. Verwenden Sie die Funktion SecondsSinceFromTimestamp2.
  • Eingabe: Zeitmarke (Zeitmarke), Zeitmarkenbasiszeichenfolge (Zeichenfolge)
  • Ausgabe: Sekunden (dfloat)
  • Beispiele. Wenn mylink.mytimestamp die Zeitmarke 2008-08-18 22:30:52 und mylink.mytimestamp_base die Zeitmarke 2008-08-19 22:30:52 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert -86400 zurück:
    SecondsSinceFromTimestamp("2008–08–18 22:30:52","2008–08–19 22:30:52")
    SecondsSinceFromTimestamp(mylink.mytimestamp, mylink.mytimestamp_base)
    
SecondsSinceFromTimestamp2
Gibt die Anzahl der Sekunden zwischen zwei Zeitmarkenobjekten zurück.
  • Eingabe: Zeitmarke (Zeitmarke), Zeitmarkenbasisobjekt (Zeitmarke)
  • Ausgabe: Sekunden (dfloat)
  • Beispiele. Wenn mylink.mytimestamp die Zeitmarke 2008-08-18 22:30:52 und mylink.mytimestamp_base die Zeitmarke 2008-08-19 22:30:52 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert -86400 zurück:
    SecondsSinceFromTimestamp2("2008–08–18 22:30:52","2008–08–19 22:30:52")
    SecondsSinceFromTimestamp2(mylink.mytimestamp, mylink.mytimestamp_base)
    
TimeDate
Gibt die Systemzeit und das Systemdatum als formatierte Zeichenfolge zurück.
  • Eingabe: Nicht zutreffend
  • Ausgabe: Systemzeit und -datum (Zeichenfolge)
  • Beispiele. Wurde der Job am 20. Juni 2008 um 16.21 Uhr ausgeführt, gibt die folgende Funktion die Zeichenfolge 16:21:48 20. Juni 2008 zurück.
    TimeDate()
    
TimeFromComponents
Gibt die entsprechende Uhrzeit für die vier separat angegebenen Werte für Stunden, Minuten, Sekunden und Mikrosekunden zurück.
  • Eingabe: Stunden (int32), Minuten (int32), Sekunden (int32), Mikrosekunden (int32)
  • Ausgabe: Zeit (Datum)
  • Beispiele. Wenn mylink.hourcol den Wert 10 enthält, enthält mylink.mincol den Wert 12, mylink.seccol den Wert 2 und mylink.mseccol 0, dann sind die beiden folgenden Funktionen äquivalent und geben die Zeit 10:12:02.0 zurück:
    TimeFromComponents(10, 12, 2, 0)
    TimeFromComponents(mylink.hourcol, mylink.mincol, mylink.seccol, mylink.mseccol)
    
TimeFromMidnightSeconds
Gibt die Uhrzeit unter Berücksichtigung der angegebenen Sekundenzahl seit Mitternacht zurück.
  • Eingabe: Sekunden (dfloat)
  • Ausgabe: Zeit (Zeit)
  • Beispiele. Wenn mylink.mymidnightseconds den Wert 240 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 00:04:00 zurück:
    TimeFromMidnightSeconds("240")
    TimeFromMidnightSeconds(mylink.mymidnightseconds)
    
TimeOffsetByComponents
Gibt die Uhrzeit für die Basiszeit unter Berücksichtigung der Offsets für Stunden, Minuten und Sekunden zurück, die als separate Werte angegeben sind. Der Offset für Sekunden kann Sekundenbruchteile enthalten.
  • Eingabe: basetime (Zeit), hour_offset (int32), minute_offset (int32), second_offset (dfloat)
  • Ausgabe: Zeit (Zeit)
  • Beispiele. Wenn 'mylink.basetime' die Uhrzeit 14:05:29 enthält und 'mylink.houros' den Wert 2, 'mylink.minos' den Wert 0 und 'mylink.secos' den Wert 20, sind die beiden folgenden Funktionen äquivalent und geben die Uhrzeit 16:05:49 zurück:
    TimeOffsetByComponents("14:05:29", 2, 0, 20)
    TimeOffsetByComponents(mylink.basetime, mylink.houros, mylink.minos, mylink.secos)
    
TimeOffsetBySeconds
Gibt die Uhrzeit für die Basiszeit unter Berücksichtigung des Offsets für Sekunden zurück. Der Offset für Sekunden kann Sekundenbruchteile enthalten.
  • Eingabe: basetime (Zeit), second_offset (dfloat)
  • Ausgabe: Zeit (Zeit)
  • Beispiele. Wenn mylink.basetime den Wert 14:05:29.30 und mylink.secos den Wert 2.5 enthält, dann sind die beiden folgenden Funktionen äquivalent und liefern die Zeit 14:05:31.80.
    TimeOffsetByComponents("14:05:29.30", 2.5)
    TimeOffsetByComponents(mylink.basetime, mylink.secos)
    
TimestampFromDateTime
Gibt eine Zeitmarke für das angegebene Datum und die angegebene Zeit zurück.
  • Eingabe: Datum (Datum), Zeit (Zeit)
  • Ausgabe: Zeitmarke (Zeitmarke)
  • Beispiele. Wenn mylink.mydate das Datum 2008-08-18 enthält und mylink.mytime die Zeit 22:30:52, sind die beiden folgenden Funktionen äquivalent und geben die Zeitmarke 2008-08-18 22:30:52 zurück:
    TimestampFromDateTime("2008–08–18","22:30:52")
    TimestampFromDateTime(mylink.mydate,mylink.mytime)
    
TimestampFromSecondsSince
Gibt eine Zeitmarke zurück die aus der Anzahl Sekunden in der Basiszeitmarke abgeleitet ist. Diese Funktion ist in IBM InfoSphere Information Server, Version 11.3, veraltet. Verwenden Sie die Funktion TimestampFromSecondsSince2.
  • Eingabe : Sekunden (Zeichenfolge), [Basiszeitstempelzeichenfolge (Zeichenfolge)]
  • Ausgabe: Zeitmarke (Zeitmarke)
  • Beispiele. Wenn 'mylink.myseconds' den Wert 2563 und 'mylink.timestamp_base ' die Zeitmarke 2008-08-18 22:30:52 enthält, sind die beiden folgenden Funktionen äquivalent und geben die Zeitmarke 2008-08-18 23:13:35 zurück:
    TimestampFromSecondsSince("2563","2008–08–18 22:30:52")
    TimestampFromSecondsSince(mylink.myseconds,mylink.timestamp_base)
TimestampFromSecondsSince2
Gibt eine Zeitmarke zurück, die aus der Anzahl Sekunden im Basiszeitmarkenobjekt abgeleitet ist.
  • Eingabe : Sekunden (Zeichenfolge), [Basiszeitstempelobjekt (Zeitstempel)]
  • Ausgabe: Zeitmarke (Zeitmarke)
  • Beispiele. Wenn 'mylink.myseconds' den Wert 2563 und 'mylink.timestamp_base ' die Zeitmarke 2008-08-18 22:30:52 enthält, sind die beiden folgenden Funktionen äquivalent und geben die Zeitmarke 2008-08-18 23:13:35 zurück:
    TimestampFromSecondsSince2("2563","2008–08–18 22:30:52")
    TimestampFromSecondsSince2(mylink.myseconds,mylink.timestamp_base)
TimestampFromTimet
Gibt eine Zeitmarke aus dem angegebenen UNIX-Zeichenfolgewert 'time_t' zurück.
  • Eingabe: timet_string (int32)
  • Ausgabe: Zeitmarke
  • Beispiele. Wenn mylink.mytimet den Wert 1234567890 enthält, sind die beiden folgenden Funktionen äquivalent und geben die Zeitmarke 2009-02-13 23:31:30 zurück:
    TimestampFromTimet("1234567890")
    TimestampFromTimet(mylink.mytimet)
TimestampFromTime2
Gibt eine Zeitmarke aus den angegebenen Objekten 'time' und 'timestamp' zurück. Der Wert aus dem Objekt 'time' überschreibt den Zeitwert im Objekt 'timestamp', d. h. es wird nur das Datum aus dem Objekt 'timestamp' verwendet.
  • Eingabe: Zeit (Zeit), Zeitmarke (Zeitmarke)
  • Ausgabe: Zeitmarke (Zeitmarke)
  • Beispiele. Wenn 'mylink.mytime' die Zeit 12:03:22 und 'mylink.mytimestamp ' die Zeitmarke 2008-08-18 22:30:52 enthält, sind die beiden folgenden Funktionen äquivalent und geben die Zeitmarke 2008-08-18 12:03:22 zurück:
    TimestampFromTime2("12:03:22", "2008–08–18 22:30:52")
    TimestampFromTime2(mylink.mytime,mylink.mytimestamp)
TimestampOffsetByComponents
Gibt die Zeitmarke für die Basiszeitmarke unter Berücksichtigung der Offsets für Jahr, Monat, Tag, Stunde, Minute und Sekunde zurück, die als separate Werte angegeben sind. Der Offset für Sekunden kann Sekundenbruchteile enthalten.
  • Eingabe: basetimestamp (Zeitmarke), year_offset (int32), month_offset (int32), dayofmonth_offset (int32), hour_offset (int32), minute_offset (int32), second_offset (dfloat)
  • Ausgabe: Zeitmarke (Zeitmarke)
  • Beispiele. Wenn 'mylink.basetimestamp' die Zeitmarke 2009-08-18 14:05:29 enthält und 'mylink.yearos' den Wert 0 sowie 'mylink.monthos' den Wert 2, 'mylink.dayos' den Wert -4, 'mylink.houros' den Wert 2, 'mylink.minos' den Wert 0 und 'mylink.secos' den Wert 20, sind die beiden folgenden Funktionen äquivalent und geben die Zeitmarke 2009-10-14 16:05:49 zurück:
    TimestampOffsetByComponents("2009-08-18 14:05:29", 0, 2, -4, 2, 0, 20)
    TimestampOffsetByComponents(mylink.basetimestamp, mylink.houros, 
    mylink.minos, mylink.secos)
    
TimestampOffsetBySeconds
Gibt die Zeitmarke für die Basiszeit unter Berücksichtigung des Offsets für Sekunden zurück. Der Offset für Sekunden kann Sekundenbruchteile enthalten.
  • Eingabe: basetimestamp (Zeitmarke), second_offset (dfloat)
  • Ausgabe: Zeitmarke (Zeitmarke)
  • Beispiele. Wenn 'mylink.basetimestamp' 2009-08-18 14:05:29 und 'mylink.secos ' den Wert 32760 enthält, sind die beiden folgenden Funktionen äquivalent und geben die Zeitmarke 2009-08-18 23:11:29 zurück:
    TimeOffsetBySeconds("2009-08-18 14:05:29", 32760)
    TimeOffsetBySeconds
    (mylink.basetimestamp, mylink.secos)
    
TimetFromTimestamp
Gibt einen UNIX-Wert 'time_t' aus der angegebenen Zeitmarke zurück.
  • Eingabe: Zeitmarke (Zeitmarke)
  • Ausgabe: Zeit (int32)
  • Beispiele. Wenn mylink.mytimestamp den Wert 2009-02-13 23:31:30 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 1234567890 zurück:
    TimestampFromTimet("2009–02–13 23:31:30")
    TimestampFromTimet(mylink.mytimestamp)
    
WeekdayFromDate
Gibt die Zahl des Wochentages aus dem angegebenen Datum zurück. Der optionale Wert 'Origin_day' gibt an, welcher Wochentag als erster Tag der Woche gilt (der Standardwert ist 'Sunday', Sonntag).
  • Eingabe: Datum (date), [origin_day (int8)]
  • Ausgabe: Tag (int8)
  • Beispiele. Wenn mylink.mydate das Datum 2008-08-18 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 1 zurück:
    WeekdayFromDate("2008-08-18")
    WeekdayFromDate(mylink.mydate)
    
    Wenn mylink.mydate das Datum 2008-08-18 und mylink.origin_day den Samstag enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 2 zurück:
    WeekdayFromDate("2008-08-18","saturday")
    WeekdayFromDate(mylink.mydate,mylink.origin_day)
    
YeardayFromDate
Gibt die Tageszahl im Jahr aus dem angegebenen Datum zurück.
  • Eingabe: Datum (Datum)
  • Ausgabe: Tag (int16)
  • Beispiele. Wenn mylink.mydate das Datum 2008-08-18 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 231 zurück:
    YeardayFromDate("2008-08-18")
    YeardayFromDate(mylink.mydate)
    
YearFromDate
Gibt das Jahr aus dem angegebenen Datum zurück.
  • Eingabe: Datum (Datum)
  • Ausgabe: Jahr (int16)
  • Beispiele. Wenn mylink.mydate das Datum 2008-08-18 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 2008 zurück:
    YearFromDate("2008-08-18")
    YearFromDate(mylink.mydate)
    
YearweekFromDate
Gibt die Nummer der Woche im Jahr aus dem angegebenen Datum zurück.
  • Eingabe: Datum (Datum)
  • Ausgabe: Woche (int16)
  • Beispiele. Wenn mylink.mydate das Datum 2008-08-18 enthält, sind die beiden folgenden Funktionen äquivalent und geben den Wert 33 zurück:
    YearweekFromDate("2008-08-18")
    YearweekFromDate(mylink.mydate)