Documentation/Calc Functions/CEILING.XCL

From The Document Foundation Wiki
Jump to navigation Jump to search
Other languages:
English • ‎dansk



Function name:

CEILING.XCL

Category:

Mathematical

Summary:

Rounds a number to the nearest multiple of a significance value. The direction of rounding is dependent on the signs of the funtion's two arguments.

Syntax:

CEILING.XCL(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 either Number or Significance is non-numeric, then CEILING.XCL reports a #VALUE! error.
  • If either Number or Significance is equal to 0, then CEILING.XCL returns 0.
  • If Number is positive and Significance is negative, then CEILING.XCL reports an invalid argument error (Err:502).

The signs of the Number and Significance arguments define the direction of rounding as defined in the following table.

Sign of Number Sign of Significance Direction of rounding
+ve (>0) +ve (>0) Up (toward +∞)
+ve (>0) -ve (<0) N/A (error condition)
-ve (<0) +ve (>0) Up (toward +∞)
-ve (<0) -ve (<0) Down (toward -∞)

Additional details:

General information about Calc's ceiling functions

Note pin.svg

For convenience, the information in this subsection is repeated on all pages describing Calc's ceiling functions.


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

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

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

Calc provides the CEILING.MATH, CEILING.PRECISE, and ISO.CEILING functions to increase interoperability with Microsoft Excel, which provides three similar functions with the same names. Calc's CEILING.PRECISE and ISO.CEILING perform identical functions.

Microsoft Excel's CEILING 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 CEILING.XCL function, as follows:

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

Examples:

Formula Description Returns
=CEILING.XCL(34.5; 4.5) Rounds up 34.5 to the nearest integer multiple of 4.5. 36
=CEILING.XCL(D1; D2) where cells D1 and D2 contain the values -45.67 and 2 respectively. Rounds up -45.67 to to the nearest integer multiple of 2. -44
=CEILING.XCL(-45.67; -2) Rounds down -45.67 to the nearest integer multiple of 2. -46

Related LibreOffice functions:

CEILING

CEILING.MATH

CEILING.PRECISE

FLOOR

FLOOR.MATH

FLOOR.PRECISE

FLOOR.XCL

INT

ISO.CEILING

ODF standard:

None

Equivalent Excel functions:

CEILING