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_BIGINT

TO_BIGINT

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

Syntax

TO_BIGINT(
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 gewünschten Wert, der in einen Bigint-Wert umgewandelt 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_BIGINT schneidet die Dezimalstellen ab, wenn für das Flag TRUE oder eine andere Zahl als 0 eingegeben wurde.
TO_BIGINT rundet den Wert auf die nächste Ganzzahl, wenn das Flag FALSE oder 0 lautet bzw. nicht angegeben ist.
Das Flag weist keine Standardeinstellung auf.

Rückgabewert

Bigint.
NULL, wenn der an die Funktion übergebene Wert NULL ist.
Wenn der an die Funktion übergebene Wert Daten enthält, die für einen Bigint-Wert 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:
TO_BIGINT( IN_TAX, TRUE )
IN_TAX
RETURN VALUE
'7245176201123435.6789'
7245176201123435
'7245176201123435.2'
7245176201123435
'7245176201123435.2.48'
7245176201123435
NULL
NULL
'A12.3Grove'
Error. Integration Service skips this row.
'    176201123435.87'
176201123435
'-7245176201123435.2'
-7245176201123435
'-7245176201123435.23'
-7245176201123435
-9223372036854775806.9
-9223372036854775806
9223372036854775806.9
9223372036854775806
TO_BIGINT( IN_TAX )
IN_TAX
RETURN VALUE
'7245176201123435.6789'
7245176201123436
'7245176201123435.2'
7245176201123435
'7245176201123435.348'
7245176201123435
NULL
NULL
'A12.3Grove'
Error. Integration Service skips this row.
'    176201123435.87'
176201123436
'-7245176201123435.6789'
-7245176201123436
'-7245176201123435.23'
-7245176201123435
-9223372036854775806.9
-9223372036854775807
9223372036854775806.9
9223372036854775807