Kategorien:

Numerische Funktionen (Rundung und Kürzung)

ROUND

Gibt gerundete Werte für den Eingabeausdruck input_expr zurück.

Siehe auch:

CEIL, FLOOR, TRUNCATE , TRUNC

Syntax

ROUND( <input_expr> [ , <scale_expr> [ , <rounding_mode> ] ] )
Copy
ROUND( EXPR => <input_expr> ,
       SCALE => <scale_expr>
       [ , ROUNDING_MODE => <rounding_mode>  ] )
Copy

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.

Wenn Sie das benannte Argument EXPR => angeben, müssen Sie auch das benannte Argument SCALE => angeben.

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.

Wenn Sie das benannte Argument SCALE => angeben, müssen Sie EXPR => als vorangehendes benanntes Argument angeben.

rounding_mode . OR . ROUNDING_MODE => rounding_mode

Der zu verwendende Rundungsmodus. Sie können einen der folgenden Werte angeben:

Standard: 'HALF_AWAY_FROM_ZERO'

Wenn Sie das benannte Argument ROUNDING_MODE => angeben, müssen Sie sowohl EXPR => als auch SCALE => als vorangehende benannte Argumente angeben.

Bemerkung

Wenn Sie einen der beiden Werte für das Argument rounding_mode angeben, muss der Datentyp von input_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 Dezimalstellenzahl der Eingabe größer oder gleich null ist, stimmt die Dezimalstellenzahl der Ausgabe im Allgemeinen mit der der Eingabe überein.

    Wenn die Dezimalstellenzahl der Eingabe negativ ist, ist die Dezimalstellenzahl der Ausgabe 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 Dezimalstellenzahl null ist, dann ist der Wert effektiv eine Ganzzahl (INTEGER).

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, gibt dies die Anzahl der Stellen vor dem Dezimalpunkt an, an die die Zahl angepasst werden soll. Wenn die Dezimalstellenzahl beispielsweise -2 ist, ist das Ergebnis ein Vielfaches von 100.

  • Wenn scale_expr größer als die Dezimalstellenzahl des Eingabeausdrucks ist, hat die Funktion keine Auswirkungen.

  • Wenn entweder input_expr oder scale_expr den Wert NULL haben, ist 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 Arguments input_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, gibt die Funktion einen Fehler zurück.

Beispiele

Das erste Beispiel ist ein einfaches Beispiel für ROUND mit der Standardanzahl der Dezimalstellen (0):

SELECT ROUND(135.135), ROUND(-975.975);
+----------------+-----------------+
| ROUND(135.135) | ROUND(-975.975) |
|----------------+-----------------|
|            135 |            -976 |
+----------------+-----------------+
Copy

Im nächsten Beispiel wird für den Parameter der Dezimalstellenzahl ein Wertebereich 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 |
+----------+-------+-----------------+
Copy

Die nächsten beiden Beispiele zeigen den Unterschied zwischen dem Standard-Rundungsmodus ('HALF_AWAY_FROM_ZERO') und dem Rundungsmodus 'HALF_TO_EVEN': In beiden Beispielen wird die Funktion ROUND zweimal aufgerufen, zuerst mit dem Standard-Rundungsverhalten, dann mit 'HALF_TO_EVEN'.

Im ersten Beispiel wird ein positiver Eingangswert von 2,5 verwendet:

SELECT ROUND(2.5, 0), ROUND(2.5, 0, 'HALF_TO_EVEN');
Copy
+---------------+-------------------------------+
| ROUND(2.5, 0) | ROUND(2.5, 0, 'HALF_TO_EVEN') |
|---------------+-------------------------------|
|             3 |                             2 |
+---------------+-------------------------------+

Im zweiten Beispiel wird ein negativer Eingangswert von -2,5 verwendet:

SELECT ROUND(-2.5, 0), ROUND(2.5, 0, 'HALF_TO_EVEN');
Copy
+---------------+--------------------------------+
| ROUND(2.5, 0) | ROUND(-2.5, 0, 'HALF_TO_EVEN') |
|---------------+--------------------------------|
|            -3 |                             -2 |
+---------------+--------------------------------+

Die nächsten beiden Beispiele zeigen, wie Sie die Argumente für die Funktion nicht über die Position, sondern über den Namen angeben.

SELECT ROUND(
  EXPR => -2.5,
  SCALE => 0);
Copy
+---------------------------------+
| ROUND(EXPR => -2.5, SCALE => 0) |
|---------------------------------|
|                              -3 |
+---------------------------------+
SELECT ROUND(
  EXPR => -2.5,
  SCALE => 0,
  ROUNDING_MODE => 'HALF_TO_EVEN');
Copy
+------------------------------------------------------------------+
| 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)
      ;
Copy

Zeigen Sie Beispiele für die 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 |
+---------+-------------+---------+-------------+
Copy