- カテゴリ：
数値関数 （四捨五入と切り捨て）
FLOOR¶
input_expr から値を、最も近い整数以下、または小数点以下の指定された桁数で最も近い整数以下に切り下げした値を返します。
- こちらもご覧ください：
構文¶
FLOOR( <input_expr> [, <scale_expr> ] )
引数¶
input_expr操作する値または式です。データ型は、 FLOAT や NUMBERなどの数値データ型のいずれかでなければなりません。
scale_expr出力の小数点の後に含める桁数です。式は-38～+38の整数に評価される必要があります。
デフォルトでは、
scale_exprはゼロになっています。これは、関数が小数点以下のすべての数字を削除することを意味します。負のスケールについては、以下の使用上の注意をご参照ください。
戻り値¶
返される値のデータ型は NUMBER（精度、スケール）です。
入力スケールがゼロ以上の場合、出力スケールは通常入力スケールと一致します。
入力スケールが負の場合、出力スケールは0です。
- 例：
FLOOR（3.14、1）によって返されるデータ型は NUMBER（4、1）です。
FLOOR（3.14、0）によって返されるデータ型は NUMBER（4、0）です。
FLOOR（33.33、-1）によって返されるデータ型は NUMBER（5、0）です。
スケールがゼロの場合、値は事実上整数になります。
使用上の注意¶
scale_exprが負の場合、数値を調整する小数点の 前 の場所の数を指定します。例えば、スケールが-2の場合、結果は100の倍数になります。scale_exprが入力式のスケールよりも大きい場合、関数は効果がありません。input_exprまたはscale_exprのいずれかが NULL の場合、結果は NULL です。負の数が切り捨てられる場合、値は0から遠くなります。たとえば、 FLOOR(-1.1) は-2であり、-1ではありません。
数値を下方に四捨五入すると、数値がデータ型の値の範囲外になる場合、エラーが返されます。
例¶
この例は、 scale_expr パラメーターなしの関数を示しています。
SELECT FLOOR(135.135), FLOOR(-975.975); +----------------+-----------------+ | FLOOR(135.135) | FLOOR(-975.975) | |----------------+-----------------| | 135 | -976 | +----------------+-----------------+
この例は、負の数値に設定されたスケールを含む、 scale_expr パラメーターを使用した関数を示しています。
テーブルを作成して入力します。
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 | +----------+-------+-----------------+