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

TO_INTEGER

TO_INTEGER

Konvertiert einen String oder numerischen Wert in eine Ganzzahl. Die Syntax von TO_INTEGER umfasst ein optionales Argument, mit dem Sie die Zahl auf die nächste Ganzzahl runden oder die Dezimalstellen abschneiden können. TO_INTEGER ignoriert vorangestellte Leerzeichen.

Syntax

TO_INTEGER(
value
[,
flag
] )
In der folgenden Tabelle werden die Argumente für diesen Befehl beschrieben:
Argument
Erforderlich/
Optional
Beschreibung
value
Erforderlich
String- oder numerischer Datentyp. Übergibt den Wert, der in eine Ganzzahl konvertiert werden soll. Sie können einen beliebigen gültigen Umwandlungausdruck eingeben.
flag
Optional
Legt fest, ob die Dezimalstellen abgeschnitten oder gerundet werden. Das Flag muss ein Ganzzahl-Literal sein oder den Konstanten TRUE oder FALSE entsprechen.
TO_INTEGER schneidet die Dezimalstellen ab, wenn für das Flag TRUE oder eine andere Zahl als 0 eingegeben wurde.
TO_INTEGER rundet den Wert auf die nächste Ganzzahl, wenn das Flag FALSE oder 0 lautet bzw. nicht angegeben ist.

Rückgabewert

Ganzzahl.
NULL, wenn der an die Funktion übergebene Wert NULL ist.
Wenn der an die Funktion übergebene Wert Daten enthält, die für einen Ganzzahlwert nicht gültig sind, markiert der Datenintegrationsdienst die Zeile als Fehlerzeile oder das Mapping schlägt fehl.

Beispiele

Die folgenden Ausdrücke verwenden Werte aus dem Port IN_TAX.
Data Integration Service
zeigt eine Fehlermeldung an, wenn die Konvertierung einen numerischen Overflow verursacht:
TO_INTEGER( IN_TAX, TRUE )
IN_TAX
RETURN VALUE
'15.6789'
15
'60.2'
60
'118.348'
118
'5,000,000,000'
Error. Integration Service skips this row.
NULL
NULL
'A12.3Grove'
Error. Integration Service skips this row.
'    123.87'
123
'-15.6789'
-15
'-15.23'
-15
TO_INTEGER( IN_TAX, FALSE)
IN_TAX
RETURN VALUE
'15.6789'
16
'60.2'
60
'118.348'
118
'5,000,000,000'
Error. Integration Service skips this row.
NULL
NULL
'A12.3Grove'
Error. Integration Service skips this row.
'    123.87'
124
'-15.6789'
-16
'-15.23'
-15