カテゴリ:

数値関数 (四捨五入と切り捨て)

FLOOR

入力式 から値を、最も近い整数以下、または小数点以下の指定された桁数で最も近い整数以下に四捨五入した値を返します。

こちらもご覧ください:

CEILROUNDTRUNCATE , TRUNC

構文

FLOOR( <input_expr> [, <scale_expr> ] )

引数

入力式

操作する値または式です。データ型は、 FLOAT や NUMBERなどの数値データ型のいずれかでなければなりません。

スケール式

出力の小数点の後に含める桁数です。式は-38~+38の整数に評価される必要があります。

デフォルトでは、 スケール式 はゼロになっています。これは、関数が小数点以下のすべての数字を削除することを意味します。

負のスケールについては、以下の使用上の注意をご参照ください。

戻り値

返される値のデータ型は NUMBER(精度、スケール)です。

入力スケールがゼロ以上の場合、出力スケールは通常入力スケールと一致します。

入力スケールが負の場合、出力スケールは0です。

例:
  • FLOOR(3.14、1)によって返されるデータ型は NUMBER(4、1)です。

  • FLOOR(3.14、0)によって返されるデータ型は NUMBER(4、0)です。

  • FLOOR(33.33、-1)によって返されるデータ型は NUMBER(5、0)です。

スケールがゼロの場合、値は事実上整数になります。

使用上の注意

  • スケール式 が負の場合、数値を調整する小数点の の場所の数を指定します。例えば、スケールが-2の場合、結果は100の倍数になります。

  • スケール式 が入力式のスケールよりも大きい場合、関数は効果がありません。

  • 入力式 または スケール式 のいずれかが NULL の場合、結果は NULLです。

  • 負の数が切り捨てられる場合、値は0から遠くなります。例えば、 FLOOR(-1.1)は-1ではなく-2です。

  • 数値を下方に四捨五入すると、数値がデータ型の値の範囲外になる場合、エラーが返されます。

この例は、 スケール式 パラメーターなしの関数を示しています。

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

この例は、負の数値に設定されたスケールを含む、 スケール式 パラメーターを使用した関数を示しています。

テーブルを作成して入力します。

CREATE TABLE test_floor (n FLOAT, scale INTEGER);
INSERT INTO test_floor (n, scale) VALUES
   (-975.975, -1),
   (-975.975,  0),
   (-975.975,  2),
   ( 135.135, -2),
   ( 135.135,  0),
   ( 135.135,  1),
   ( 135.135,  3),
   ( 135.135, 50),
   ( 135.135, NULL)
   ;

出力:

SELECT n, scale, FLOOR(n, scale)
  FROM test_floor
  ORDER BY n, scale;
+----------+-------+-----------------+
|        N | SCALE | FLOOR(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 |
+----------+-------+-----------------+