8.4.2 CEIL

Returns the smallest integer that is equal to or greater than the target data.

Organization of this subsection

(1) Specification format

scalar-function-CEIL ::= CEIL(target-data)
 
  target-data ::= value-expression

target-data:

Specifies the numeric data to be processed.

The following rules apply:

Specify the target data in the form of a value expression. For details about value expressions, see 7.20 Value expression.
Specify numeric data for the target data. For details about numeric data, see (1) Numeric data in 6.2.1 List of data types.
You cannot specify a dynamic parameter by itself for the target data.

The data type of the execution result is shown in the following table.

Table 8‒2: Data type of the execution result of the scalar function CEIL
Data type of the target data	Data type of the execution result
`INTEGER`	`INTEGER`
`SMALLINT`	`SMALLINT`
`DECIMAL(p,s)`	`DECIMAL(p,0)`
`DOUBLE` `PRECISION`	`DOUBLE` `PRECISION`

The NOT NULL constraint does not apply to the value of the execution result (the null value is allowed).
If the target data has the null value, the execution result will be a null value.

Example:

Determine the smallest integer that is equal to or greater than the value of column C1 in table T1, and similarly for columns C2 and C3.

SELECT CEIL("C1"),CEIL("C2"),CEIL("C3") FROM "T1"

[Figure]