- Kategorien:
Numerische Funktionen (Rundung und Kürzung)
ROUND¶
Gibt gerundete Werte für den Eingabeausdruck input_expr
zurück.
- Siehe auch:
Syntax¶
ROUND( <input_expr> [ , <scale_expr> [ , <rounding_mode> ] ] )
ROUND( EXPR => <input_expr>
[ , SCALE => <scale_expr> [ , ROUNDING_MODE => <rounding_mode> ] ] )
Argumente¶
Erforderlich:
input_expr
. OR .EXPR => input_expr
Der Wert oder Ausdruck, der verarbeitet werden soll. Der Datentyp sollte aus einem der numerischen Datentypen bestehen, z. B. FLOAT oder NUMBER.
Optional:
scale_expr
. OR .SCALE => scale_expr
Die Anzahl der Stellen, die die Ausgabe nach dem Dezimalpunkt enthalten soll. Der Ausdruck sollte eine Ganzzahl von -38 bis +38 ergeben.
Der Standardwert für
scale_expr
ist null. Das bedeutet, dass die Funktion alle Nachkommastellen entfernt.Informationen zu negativen Zahlen finden Sie in den folgenden Nutzungshinweisen.
rounding_mode
. OR .ROUNDING_MODE => rounding_mode
Der zu verwendende Rundungsmodus. Sie können einen der folgenden Werte angeben:
'HALF_AWAY_FROM_ZERO'
. Bei diesem Modus werden halbe Werte weg von Null gerundet.'HALF_TO_EVEN'
. Bei diesem Modus werden halbe Werte auf das nächste gerade Ergebnis gerundet.
Standard:
'HALF_AWAY_FROM_ZERO'
Bemerkung
Wenn Sie einen der beiden Werte für das Argument
rounding_mode
angeben, muss der Datentyp voninput_expr
einer der Datentypen für eine Festkommazahl sein.Datentypen für Gleitkommazahlen (z. B. FLOAT) werden bei diesem Argument nicht unterstützt.
Rückgabewerte¶
Der Rückgabetyp richtet sich nach dem Eingabetyp:
Wenn der Eingabetyp FLOAT ist, dann ist der Datentyp des zurückgegebenen Werts FLOAT.
Wenn der Eingabetyp NUMBER ist, dann ist der Datentyp des zurückgegebenen Werts NUMBER.
Wenn die Eingabeskalierung größer oder gleich null war, stimmt die Ausgabeskalierung im Allgemeinen mit der Eingabeskalierung überein.
Wenn die Eingabeskalierung negativ war, lautet die Ausgabeskalierung 0.
Beispiel:
Der von ROUND(3,14::NUMBER(4, 1), 1) zurückgegebene Datentyp ist NUMBER(4, 1).
Der von ROUND(3,14::NUMBER(4, 0), 0) zurückgegebene Datentyp ist NUMBER(4, 0).
Wenn die Skalierung null ist, dann ist der Wert effektiv eine Ganzzahl.
Nutzungshinweise¶
Sie müssen alle Argumente entweder über den Namen oder über die Position angeben. Sie können nicht einige der Argumente über den Namen und andere Argumente über die Position angeben.
Wenn Sie ein Argument über den Namen angeben, können Sie den Argumentnamen nicht in doppelten Anführungszeichen einschließen.
Wenn
scale_expr
negativ ist, wird die Anzahl der Stellen vor dem Dezimalpunkt angegeben, an die die Zahl angepasst werden soll. Wenn die Skalierung beispielsweise -2 beträgt, ist das Ergebnis ein Vielfaches von 100.Wenn
scale_expr
größer als die Anzahl der Nachkommastellen des Eingabeausdrucks ist, hat die Funktion keine Auswirkungen.Wenn entweder
input_expr
oderscale_expr
den Wert NULL haben, lautet das Ergebnis NULL.Standardmäßig werden bei Dezimalzahlen halbe Werte von Null weg gerundet. Beispielsweise wird -0,5 auf -1,0 gerundet.
Um den Rundungsmodus so zu ändern, dass der halbe Wert auf gerade gerundet wird (z. B. -0,5 auf 0), übergeben Sie dem Argument
rounding_mode
den Wert'HALF_TO_EVEN'
.Bemerkung
Wenn Sie das Argument
rounding_mode
angeben, muss der Datentyp des Argumentsinput_expr
einer der Datentypen für eine Festkommazahl sein.Gleitkommazahlen sind approximierte Werte. Eine Gleitkommazahl wird möglicherweise nicht wie erwartet gerundet.
Wenn die Zahl durch Runden außerhalb des Wertebereichs des Datentyps liegt, wird ein Fehler zurückgegeben.
Beispiele¶
Das erste Beispiel ist ein einfaches Beispiel für ROUND
mit der Standardzahl von Dezimalstellen (0):
SELECT ROUND(135.135), ROUND(-975.975);
+----------------+-----------------+
| ROUND(135.135) | ROUND(-975.975) |
|----------------+-----------------|
| 135 | -976 |
+----------------+-----------------+
Im nächsten Beispiel wird ein Wertebereich für den Skalierungsparameter verwendet:
SELECT n, scale, ROUND(n, scale)
FROM test_ceiling
ORDER BY n, scale;
+----------+-------+-----------------+
| N | SCALE | ROUND(N, SCALE) |
|----------+-------+-----------------|
| -975.975 | -1 | -980 |
| -975.975 | 0 | -976 |
| -975.975 | 2 | -975.98 |
| 135.135 | -2 | 100 |
| 135.135 | 0 | 135 |
| 135.135 | 1 | 135.1 |
| 135.135 | 3 | 135.135 |
| 135.135 | 50 | 135.135 |
| 135.135 | NULL | NULL |
+----------+-------+-----------------+
Das nächste Beispiel zeigt den Unterschied zwischen dem Standard-Rundungsmodus ('HALF_AWAY_FROM_ZERO'
) und dem Rundungsmodus 'HALF_TO_EVEN'
:
SELECT ROUND(2.5, 0), ROUND(2.5, 0, 'HALF_TO_EVEN');
+---------------+-------------------------------+
| ROUND(2.5, 0) | ROUND(2.5, 0, 'HALF_TO_EVEN') |
|---------------+-------------------------------|
| 3 | 2 |
+---------------+-------------------------------+
SELECT ROUND(-2.5, 0), ROUND(-2.5, 0, 'HALF_TO_EVEN');
+----------------+--------------------------------+
| ROUND(-2.5, 0) | ROUND(-2.5, 0, 'HALF_TO_EVEN') |
|----------------+--------------------------------|
| -3 | -2 |
+----------------+--------------------------------+
Das nächste Beispiel zeigt, wie Sie die Argumente für die Funktion nicht über die Position, sondern über den Namen angeben.
SELECT ROUND(
EXPR => -2.5,
SCALE => 0,
ROUNDING_MODE => 'HALF_TO_EVEN');
+------------------------------------------------------------------+
| ROUND(EXPR => -2.5, SCALE => 0, ROUNDING_MODE => 'HALF_TO_EVEN') |
|------------------------------------------------------------------|
| -2 |
+------------------------------------------------------------------+
Das nächste Beispiel zeigt, dass FLOAT-Werte nicht immer genau gespeichert werden. Wie Sie unten sehen können, wird .005 in einigen Fällen auf .01 gerundet, während in anderen Fällen auf 0 gerundet wird. Der Unterschied hängt nicht mit der Rundung zusammen; vielmehr hat er mit der zugrunde liegenden Darstellung der Gleitkommazahl zu tun. 1.005 wird als Zahl gespeichert, die etwas kleiner als 1.005 ist (ungefähr 1.004999). Der DECIMAL-Wert wird jedoch als exakte Zahl gespeichert und wie in allen Fällen erwartet auf .01 gerundet.
Erstellen und laden Sie eine Tabelle:
CREATE OR REPLACE TEMP TABLE rnd1(f float, d DECIMAL(10, 3)); INSERT INTO rnd1 (f, d) VALUES ( -10.005, -10.005), ( -1.005, -1.005), ( 1.005, 1.005), ( 10.005, 10.005) ;Zeigen Sie Beispiele für Unterschiede zwischen gerundeten FLOAT-Werten und gerundeten DECIMAL-Werten an:
select f, round(f, 2), d, round(d, 2) from rnd1 order by 1; +---------+-------------+---------+-------------+ | F | ROUND(F, 2) | D | ROUND(D, 2) | |---------+-------------+---------+-------------| | -10.005 | -10.01 | -10.005 | -10.01 | | -1.005 | -1 | -1.005 | -1.01 | | 1.005 | 1 | 1.005 | 1.01 | | 10.005 | 10.01 | 10.005 | 10.01 | +---------+-------------+---------+-------------+