Ansicht
Dokumentation

ABENSQL_TIME_FUNC - SQL TIME FUNC

TXBHW - Original Tax Base Amount in Local Currency   ABAP Short Reference  
Diese Dokumentation steht unter dem Copyright der SAP AG.

- Zeitfunktionen

Generische Zeitfunktionen

1. ... IS_VALID( date$|time$|utclong )
    $| EXTRACT_HOUR( time$|utclong )
    $| EXTRACT_MINUTE( time$|utclong )
    $| EXTRACT_SECOND( time$|utclong ) ...

Funktionen für TIMS

2. ... TIMS_IS_VALID( time ) ...

Wirkung

Diese SQL-Funktionen führen Operationen auf Zeitangaben mit Argumenten der eingebauten Datentypen DATS, DATN, TIMN, TIMS und UTCLONG durch. Die erste Gruppe umfasst generische Funktionen und die zweite eine vom Datentyp TIMS abhängige Funktion. Die Argumente der Funktionen werden in runden Klammern als kommaseparierte Liste angegeben. Hinter der öffnenden und vor der schließenden runden Klammer muss ein Leerzeichen stehen. Als Aktualparameter können SQL-Ausdrücke passender Datentypen übergeben werden. Wenn ein Aktualparameter den Null-Wert enthält, gibt jede Funktion außer IS_VALID und TIMS_IS_VALID einen Null-Wert zurück.

Generische Zeitfunktionen

... IS_VALID( date$|time$|utclong )
  $| EXTRACT_HOUR( time$|utclong )
  $| EXTRACT_MINUTE( time$|utclong )
  $| EXTRACT_SECOND( time$|utclong ) ...

Varianten:

1. ... IS_VALID( date$|time$|utclong ) ...

2. ... EXTRACT_HOUR( time$|utclong ) ...

3. ... EXTRACT_MINUTE( time$|utclong ) ...

4. ... EXTRACT_SECOND( time$|utclong ) ...

Wirkung

Diese SQL-Funktionen führen Operationen mit Argumenten der eingebauten Datentypen DATN, DATS, TIMN, TIMS und UTCLONG durch.

Hinweis

Alle generischen Funktionen erzwingen den strikten-Modus ab Release .

Variante 1

... IS_VALID( date$|time$|utclong ) ...

Wirkung

Die generische Funktion IS_VALID ermittelt, ob

• die Angabe date ein gültiges Datum im Format YYYYMMDD enthält. Der Aktualparameter muss vom eingebauten Datentyp DATN oder DATS sein.

• die Angabe time eine gültige Zeit im Format HHMMSS enthält. Der Aktualparameter muss vom eingebauten Datentyp TIMN oder TIMS sein.

• die Angabe utclong einen gültigen Zeitstempel wie 0001-01-01T00:00:00.0000000 enthält. Der Aktualparameter muss vom eingebauten Datentyp UTCLONG sein.

Das Ergebnis ist vom Datentyp INT4. Eine gültige Zeitangabe und der leere Wert (für die Datentypen TIMN und TIMS) ergeben den Wert 1 and alle anderen Eingabewerte (inklusive des Null-Werts) ergeben den Wert 0.

Hinweis

Die generische Funktion IS_VALID gilt auch für Datumsfunktionen und Zeitstempelfunktionen.

Beispiel

Anwendung der generischen Funktion auf eine Zeitspalte der DDIC-Datenbanktabelle DEMO_EXPRESSIONS.

Variante 2

... EXTRACT_HOUR( time$|utclong ) ...

Wirkung

Mit der generischen Funktion EXTRACT_HOUR wird die Stunde einer Zeit oder eines Zeitstempels extrahiert. Der Aktualparameter muss vom eingebauten Datentyp TIMN, TIMS oder UTCLONG sein.

Das Ergebnis der Funktion EXTRACT_HOUR ist vom Datentyp INT4. Die Funktion gibt für initiale Eingabewerte den Wert 0 zurück. Falls keine gültige Zeit als ein TIMS-Wert übergeben wird, kommt es bei der Funktion EXTRACT_HOUR zu einer abfangbaren Ausnahme der Klasse CX_SY_OPEN_SQL_DB.

Hinweise

• Falls der eingebaute Datentyp TIMN oder UTCLONG verwendet wird, ruft die Funktion EXTRACT_HOUR die HANA-Funktion EXTRACT auf.

• Falls der eingebaute Datentyp TIMS verwendet wird, verwendet die Funktion EXTRACT_HOUR intern die ABAP-SQL-Funktion SUBSTRING und nachher einen CAST-Ausdruck. Es gelten die jeweiligen Regeln.
  
  

Variante 3

... EXTRACT_MINUTE( time$|utclong ) ...

Wirkung

Mit der generischen Funktion EXTRACT_MINUTE wird die Minute einer Zeit oder eines Zeitstempels extrahiert. Der Aktualparameter muss vom eingebauten Datentyp TIMN, TIMS oder UTCLONG sein.

Das Ergebnis der Funktion EXTRACT_MINUTE ist vom Datentyp INT4. Die Funktion gibt für initiale Eingabewerte den Wert 0 zurück. Falls keine gültige Zeit als ein TIMS-Wert übergeben wird, kommt es bei der Funktion EXTRACT_MINUTE zu einer abfangbaren Ausnahme der Klasse CX_SY_OPEN_SQL_DB.

Hinweise

• Falls der eingebaute Datentyp TIMN oder UTCLONG verwendet wird, ruft die Funktion EXTRACT_MINUTE die HANA-Funktion EXTRACT auf.

• Falls der eingebaute Datentyp TIMS verwendet wird, verwendet die Funktion EXTRACT_MINUTE intern die ABAP-SQL-Funktion SUBSTRING und nachher einen CAST-Ausdruck. Es gelten die jeweiligen Regeln.
  
  

Variante 4

... EXTRACT_SECOND( time$|utclong ) ...

Wirkung

Mit der generischen Funktion EXTRACT_SECOND wird die Sekunde einer Zeit oder eines Zeitstempels extrahiert. Der Aktualparameter muss vom eingebauten Datentyp TIMN, TIMS oder UTCLONG sein.

Das Ergebnis der Funktion EXTRACT_SECOND ist vom Datentyp INT4. Die Funktion gibt für initiale Eingabewerte den Wert 0 zurück. Falls keine gültige Zeit als ein TIMS-Wert übergeben wird, kommt es bei der Funktion EXTRACT_SECOND zu einer abfangbaren Ausnahme der Klasse CX_SY_OPEN_SQL_DB.

Hinweise

• Falls der eingebaute Datentyp TIMN oder UTCLONG verwendet wird, ruft die Funktion EXTRACT_SECOND die HANA-Funktion EXTRACT auf.

• Falls der eingebaute Datentyp TIMS verwendet wird, verwendet die Funktion EXTRACT_SECOND intern die ABAP-SQL-Funktion SUBSTRING und nachher einen CAST-Ausdruck. Es gelten die jeweiligen Regeln.
  
  

Beispiel

Anwendung der generischen Funktionen auf Zeit- und Zeitstempelspalten der DDIC-Datenbanktabelle DEMO_EXPRESSIONS.

Funktionen für TIMS

... TIMS_IS_VALID( time ) ...

Varianten:

1. ... TIMS_IS_VALID( time )

Wirkung

Diese SQL-Funktionen führen Operationen mit Argumenten des eingebauten Datentyps TIMS durch.

Variante 1

... TIMS_IS_VALID( time )

Wirkung

Die Funktion TIMS_IS_VALID stellt fest, ob eine Angabe time eine gültige Zeit im Format HHMMSS enthält. Der Aktualparameter muss vom eingebauten Datentyp TIMS sein. Das Ergebnis ist vom Datentyp INT4. Eine gültige Zeitangabe und der leere Wert ergeben den Wert 1 und alle anderen Eingabewerte inklusive des Null-Werts ergeben den Wert 0.

Hinweis

Die Verwendung dieser Funktion führt zum strikten Modus ab Release .

Beispiel

Anwendung der Zeitfunktion auf eine Zeitspalte der DDIC-Datenbanktabelle DEMO_EXPRESSIONS. Das Programm DEMO_SQL_TIME_FUNCTIONS führt diesen Zugriff aus und stellt das Ergebnis dar.

BAL Application Log Documentation   BAL Application Log Documentation  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 14093 Date: 20240523 Time: 120348     sap01-206 ( 206 ms )