Inhaltsverzeichnis

Search

  1. Vorwort
  2. Umwandlungssprache
  3. Konstanten
  4. Operatoren
  5. Variablen
  6. Datumsangaben
  7. Funktionen

Referenzhandbuch für die Umwandlungssprache

Referenzhandbuch für die Umwandlungssprache

ADD_TO_DATE

ADD_TO_DATE

Fügt einem Teil eines Datetime-Werts eine angegebene Menge hinzu und gibt ein Datum in demselben Format zurück wie das Datum, das an die Funktion übergeben wird. ADD_TO_DATE akzeptiert positive und negative Ganzzahlwerte. Verwenden Sie ADD_TO_DATE, um folgende Teile eines Datums zu ändern:
  • Jahr.
    Geben Sie eine positive oder negative Ganzzahl in das Argument
    amount
    ein. Verwenden Sie den Formatstring für Jahr, den Sie möchten: Y Y, YY, YYY oder YYYY. Der folgende Ausdruck fügt allen Datumsangaben im Port SHIP_DATE 10 Jahre hinzu:
    ADD_TO_DATE ( SHIP_DATE, 'YY', 10 )
  • Monat.
    Geben Sie eine positive oder negative Ganzzahl in das Argument
    amount
    ein. Verwenden Sie den Formatstring für Monat, den Sie möchten: MM, MON, MONTH. Der folgende Ausdruck zieht von allen Datumsangaben im Port SHIP_DATE 10 Monate ab:
    ADD_TO_DATE( SHIP_DATE, 'MONTH', -10 )
  • Tag.
    Geben Sie eine positive oder negative Ganzzahl in das Argument
    amount
    ein. Verwenden Sie den Formatstring für Tag, den Sie möchten: D, DD, DDD, DY und DAY. Der folgende Ausdruck fügt allen Datumsangaben im Port SHIP_DATE 10 Tage hinzu:
    ADD_TO_DATE( SHIP_DATE, 'DD', 10 )
  • Stunde.
    Geben Sie eine positive oder negative Ganzzahl in das Argument
    amount
    ein. Verwenden Sie den Formatstring für Stunde, den Sie möchten: HH, HH12, HH24. Der folgende Ausdruck fügt allen Datumsangaben im Port SHIP_DATE 14 Stunden hinzu:
    ADD_TO_DATE( SHIP_DATE, 'HH', 14 )
  • Minute.
    Geben Sie eine positive oder negative Ganzzahl in das Argument
    amount
    ein. Verwenden Sie zum Festlegen der Minuten den Formatstring MI. Der folgende Ausdruck fügt allen Datumsangaben im Port SHIP_DATE 25 Minuten hinzu:
    ADD_TO_DATE( SHIP_DATE, 'MI', 25 )
  • Sekunden.
    Geben Sie eine positive oder negative Ganzzahl in das Argument
    amount
    ein. Verwenden Sie zum Festlegen der Sekunden den Formatstring SS. Der folgende Ausdruck fügt allen Datumsangaben im Port SHIP_DATE 59 Sekunden hinzu:
    ADD_TO_DATE( SHIP_DATE, 'SS', 59 )
  • Millisekunden.
    Geben Sie eine positive oder negative Ganzzahl in das Argument
    amount
    ein. Verwenden Sie zum Festlegen der Millisekunden den Formatstring MS. Der folgende Ausdruck fügt allen Datumsangaben im Port SHIP_DATE 125 Millisekunden hinzu:
    ADD_TO_DATE( SHIP_DATE, 'MS', 125 )
  • Mikrosekunden.
    Geben Sie eine positive oder negative Ganzzahl in das Argument
    amount
    ein. Verwenden Sie zum Festlegen der Mikrosekunden den Formatstring US. Der folgende Ausdruck fügt allen Datumsangaben im Port SHIP_DATE 2000 Mikrosekunden hinzu:
    ADD_TO_DATE( SHIP_DATE, 'US', 2000 )
  • Nanosekunden.
    Geben Sie eine positive oder negative Ganzzahl in das Argument
    amount
    ein. Verwenden Sie zum Festlegen der Nanosekunden den Formatstring NS. Der folgende Ausdruck fügt allen Datumsangaben im Port SHIP_DATE 3 000 000 Nanosekunden hinzu:
    ADD_TO_DATE( SHIP_DATE, 'NS', 3000000 )

Syntax

ADD_TO_DATE( 
date
,
format
,
amount
 )
In der folgenden Tabelle werden die Argumente für diesen Befehl beschrieben:
Argument
Erforderlich/
Optional
Beschreibung
Datum
Erforderlich
Datum/Zeit-Datentyp. Übergibt die Werte, die Sie ändern möchten. Sie können einen beliebigen gültigen Umwandlungausdruck eingeben.
format
Erforderlich
Formatstring zur Angabe des Teils des Datums, den Sie ändern möchten. Setzen Sie den Formatstring zwischen einfache Anführungszeichen, z. B. 'MM'. Bei Formatstrings muss nicht auf Groß-/Kleinschreibung geachtet werden.
amount
Erforderlich
Ganzzahliger Wert, der die Menge von Jahren, Monate, Tagen, Stunden usw. angibt, um die Sie den Datumswert ändern möchten. Sie können jeden beliebigen Umwandlungsausdruck eingeben, dessen Auswertung eine Ganzzahl ergibt.

Rückgabewert

Das Datum wird in demselben Format zurückgegeben wie das übergebene Datum.
NULL, wenn der Funktion ein Nullwert als Argument übergeben wird.

Beispiele

Alle nachstehenden Ausdrücke fügen jeder Datumsangabe im Port DATE_SHIPPED einen Monat hinzu. Bei Übergabe eines Werts, der einen Tag erstellt, den es in einem bestimmten Monat nicht gibt, gibt
Data Integration Service
den letzten Tag des betreffenden Monats zurück. Beispiel: Sie fügen dem 31. Januar 1998 einen Monat hinzu.
Data Integration Service
gibt in diesem Fall den 28. Februar 1998 zurück.
Beachten Sie außerdem, dass ADD_TO_DATE Schaltjahre erkennt und dem 29. Januar 2000 einen Monat hinzufügt:
ADD_TO_DATE( DATE_SHIPPED, 'MM', 1 ) ADD_TO_DATE( DATE_SHIPPED, 'MON', 1 ) ADD_TO_DATE( DATE_SHIPPED, 'MONTH', 1 )
DATE_SHIPPED
RETURN VALUE
Jan 12 1998 12:00:30AM
Feb 12 1998 12:00:30AM
Jan 31 1998 6:24:45PM
Feb 28 1998 6:24:45PM
Jan 29 2000 5:32:12AM
Feb 29 2000 5:32:12AM
  (Leap Year)
Oct 9 1998 2:30:12PM
Nov 9 1998 2:30:12PM
NULL
NULL
Die folgenden Ausdrücke ziehen von allen Datumsangaben im Port DATE_SHIPPED 10 Tage ab:
ADD_TO_DATE( DATE_SHIPPED, 'D', -10 ) ADD_TO_DATE( DATE_SHIPPED, 'DD', -10 ) ADD_TO_DATE( DATE_SHIPPED, 'DDD', -10 ) ADD_TO_DATE( DATE_SHIPPED, 'DY', -10 ) ADD_TO_DATE( DATE_SHIPPED, 'DAY', -10 )
DATE_SHIPPED
RETURN VALUE
Jan 1 1997 12:00:30AM
Dec 22 1996 12:00AM
Jan 31 1997 6:24:45PM
Jan 21 1997 6:24:45PM
Mar 9 1996 5:32:12AM
Feb 29 1996 5:32:12AM
  (Leap Year)
Oct 9 1997 2:30:12PM
Sep 30 1997 2:30:12PM
Mar 3 1996 5:12:20AM
Feb 22 1996 5:12:20AM
NULL
NULL
Die folgenden Ausdrücke ziehen von allen Datumsangaben im Port DATE_SHIPPED 15 Stunden ab:
ADD_TO_DATE( DATE_SHIPPED, 'HH', -15 ) ADD_TO_DATE( DATE_SHIPPED, 'HH12', -15 ) ADD_TO_DATE( DATE_SHIPPED, 'HH24', -15 )
DATE_SHIPPED
RETURN VALUE
Jan 1 1997 12:00:30AM
Dec 31 1996 9:00:30AM
Jan 31 1997 6:24:45PM
Jan 31 1997 3:24:45AM
Oct 9 1997 2:30:12PM
Oct 8 1997 11:30:12PM
Mar 3 1996 5:12:20AM
Mar 2 1996 2:12:20PM
Mar 1 1996 5:32:12AM
Feb 29 1996 2:32:12PM
  (Leap Year)
NULL
NULL

Arbeiten mit Datumsangaben

Folgende Tipps helfen Ihnen bei der Arbeit mit ADD_TO_DATE:
  • Zum Hinzufügen oder Abziehen eines Teils eines Datums geben Sie einen Formatstring an und legen für das Argument
    amount
    eine positive oder negative Ganzzahl fest.
  • Bei Übergabe eines Werts, der einen Tag erstellt, den es in einem bestimmten Monat nicht gibt, gibt
    Data Integration Service
    den letzten Tag des betreffenden Monats zurück. Beispiel: Sie fügen dem 31. Januar 1998 einen Monat hinzu.
    Data Integration Service
    gibt in diesem Fall den 28. Februar 1998 zurück.
  • Die Funktionen TRUNC und ROUND können verschachtelt werden, um Datumsangaben zu bearbeiten.
  • TO_DATE kann verschachtelt werden, um Strings in Datumsangaben zu konvertieren.
  • ADD_TO_DATE ändert nur einen Teil des Datums, und zwar den, den Sie angeben. Wenn Sie ein Datum von Sommer- auf Winterzeit ändern, müssen Sie die Stundenkomponente des Datums ändern.