Jump to content

Documentation/Calc Functions/FLOOR.PRECISE

From The Document Foundation Wiki


Function name:

FLOOR.PRECISE

Category:

Mathematical

Summary:

Rounds a number to the nearest multiple of a significance value. In all cases, the number is rounded down (toward -∞).

Syntax:

FLOOR.PRECISE(Number [; Significance])

Returns:

Returns a real number that is the rounded value and is an integer multiple of the significance value.

Arguments:

Number is a real number, or a reference to a cell containing that number, that is the value to be rounded.

Significance is a real number, or a reference to a cell containing that number, that is the significance value to be used. If omitted, Significance defaults to 1. The sign of Significance is ignored.

  • If either argument is non-numeric, then FLOOR.PRECISE reports a #VALUE! error.
  • If either Number or Significance is equal to 0, then FLOOR.PRECISE returns 0.

Additional details:

General information about Calc's floor functions

Note:
For convenience, the information in this subsection is repeated on all pages describing Calc’s floor functions.

General introductory information about floor functions can be found at Wikipedia's Floor and ceiling functions page.

Calc provides four functions that can be used to calculate the floor value of a number, and these are:

The most important of these for many users will be the FLOOR function, which implements the requirements laid out in Section 6.17.3 of ODF 1.2, Part 2.

Calc provides the FLOOR.MATH, and FLOOR.PRECISE functions to increase interoperability with Microsoft Excel, which provides two similar functions with the same names.

Microsoft Excel's FLOOR function accepts two arguments and so is not compliant with ODF 1.2. This difference in behaviour could lead to interoperability problems but these are avoided through the provision of the FLOOR.XCL function, as follows:

  • When Calc saves a spreadsheet to Excel 2007-365 (*.xlsx) format, any call to Calc's FLOOR function is converted to a call to Excel's FLOOR.MATH function, and any call to Calc's FLOOR.XCL function is converted to a call to Excel's FLOOR function.
  • When Calc opens a spreadsheet in Excel 2007-365 (*.xlsx) format, any call to Excel's FLOOR function is converted to a call to Calc's FLOOR.XCL function.

Examples:

Formula Description Returns
=FLOOR.PRECISE(11.5) Significance defaults to 1. The function rounds down 11.5 to the nearest integer multiple of 1. 11
=FLOOR.PRECISE(−11.5) Significance defaults to 1. The function rounds down -11.5 to the nearest integer multiple of 1. −12
=FLOOR.PRECISE(7; 2.3) The function rounds down 7 to the nearest integer multiple of 2.3. 6.9
=FLOOR.PRECISE(−7; −2.3) The function rounds down -7 to the nearest integer multiple of 2.3 (the sign of the significance value is ignored). −9.2
=FLOOR.PRECISE(D1; D2) where cells D1 and D2 contain the numbers 10 and 3 respectively. The function rounds down the value 10 to the nearest integer multiple of 3. 9

Related LibreOffice functions:

CEILING

CEILING.MATH

CEILING.PRECISE

CEILING.XCL

FLOOR

FLOOR.MATH

FLOOR.XCL

INT

ISO.CEILING

ODF standard:

None

Related (or similar) Excel functions:

FLOOR.PRECISE since v.2010.