Home
Function Reference
1010data Insights Platform offers a rich set of functions that may be used in value expressions when creating computed columns and in selection expressions when performing row selections.
Math functions
Math functions are vector functions that perform mathematical operations on one or more columns and return a column of results based on the operation.
General
ceil(X)
Returns the smallest integer greater than or equal to the given value. The result is a decimal data type.

Function Reference
1010data Insights Platform offers a rich set of functions that may be used in value expressions when creating computed columns and in selection expressions when performing row selections.
- All 1010data Functions
  1010data provides a whole range of functions that can provide information and act on your data.
- Time/Date functions
  The time/date functions are vector functions that operate on columns containing time-related data and return specific information about the date/time for each row.
- Group functions (g_functions)
  Group functions, or g_functions, are used to perform operations, such as summarizations, on rows that have the same values in a set of given columns.
- Math functions
  Math functions are vector functions that perform mathematical operations on one or more columns and return a column of results based on the operation.
  - General
    - abs(X)
      Returns the absolute value of a given value.
    - between(X;Y;Z)
      Returns a boolean value indicating whether a given value is between two other values.
    - bigint(X)
      Returns the given value cast to a big integer data type. (Available as of version 11.11)
    - ceil(X)
      Returns the smallest integer greater than or equal to the given value. The result is a decimal data type.
    - clamp(X;Y;Z)
      Returns Y if X<Y and Z if X>Z. Otherwise, if the "clamped" value X is between Y and Z, clamp(X;Y;Z) returns X. (Available as of version 18.37)
    - clip(X;Y;Z)
      Returns NA if X is "out of bounds", that is, X<Y or X>Z. Otherwise, clip(X;Y;Z) returns X. (Available as of version 18.37)
    - clipout(X;Y;Z)
      Returns NA if X is "in bounds", that is, X>=Y or X<=Z. Otherwise, clipout(X;Y;Z) returns X. (Available as of version 18.37)
    - floor(X)
      Returns the largest integer less than or equal to the given value. The result is a decimal data type.
    - idiv(X;Y)
      Returns the quotient after dividing one integer value by another. The result is an integer data type.
    - imod(X;Y)
      Returns the remainder after dividing one integer value by another. The result is an integer data type.
    - int(X)
      Returns the largest integer less than or equal to the given value. The result is an integer data type.
    - max(X;Y)
      Returns the larger of two given values.
    - min(X;Y)
      Returns the smaller of two given values.
    - mod(X;Y)
      Returns the modulo of two given values.
    - real(X)
      Returns the given value cast to decimal data type.
    - round(X;Y)
      Returns the result of rounding the first given value to the nearest multiple of the second given value.
    - signum(X)
      Returns the sign number (-1, 0, or 1) of a given value. (Available as of version 15.20)
    - svvs(X;Y;Z;I;B)
      Decode and then encode a value based on an index.
    - trunc(X;Y)
      Returns the result of rounding the first given value to the multiple of the second given value, always rounding in the direction of 0. (Available as of version 16.02)
  - Exponential
  - Trigonometric
  - Factorial
  - Statistical
  - Bitwise
- Matrix functions
- Categorization functions
  Categorization functions are vector functions that organize data and determine logical groupings. These functions can be used for conditionalizing results and/or bucketing value ranges.
- String functions
  String functions are vector functions that manipulate vectors of strings to provide information about a string or substring, concatenate and split strings, or transform strings based on specified criteria.
- List functions
  List functions are scalar functions that return lists, subsets of lists, and combinations of lists, among other functionality. Lists, along with packages, are compound scalar data types that facilitate programmatic interaction with scalar data values and variables.
- Data-handling functions
  Data-handling functions are vector functions that return a hash value based on an input column or columns.
- Row functions
  Row functions are vector functions that return computational outputs for row inputs, as opposed to column outputs. Row inputs are defined as a space- or comma-separated list of column names.
- SQL compatibility functions
  SQL compatibility functions are functions that treat null values as SQL nulls.
- Financial functions
- System functions
  System functions are special functions in 1010data that return information about users, tables, and other system objects.
- Object functions
  The object functions can be used to check the existence, type, and accessibility of objects such as folders, tables, and queries on the 1010data Insights Platform.
- Miscellaneous functions
  This category of functions contains special functions that don't neatly fit into other categories of functions.

`ceil(X)`

Returns the smallest integer greater than or equal to the given value. The result is a decimal data type.

Syntax

ceil(X)

Input

Argument	Type	Description
`X`	any numeric type	A numeric value

Return Value

Returns a decimal value corresponding to the smallest integer greater than or equal to X.

If X is N/A, the result is N/A.

Sample Usage

<table cols="int_value,dec_value" types="i,f">
 1,-5.25;
 2,5.0;
 3,13;
 4,4.5;
 5,5.0;
</table>
<willbe name="ceil_int_example" value="ceil(int_value)"/>
<willbe name="ceil_dec_example" value="ceil(dec_value)"/>
<colord cols="int_value,ceil_int_example,dec_value,ceil_dec_example"/>

Example

In this example, the ceil(X) function returns the smallest integer greater than or equal to the given value of the cost column on the pub.demo.retail.item table. The new column contains decimal data type values.

<base table="pub.demo.retail.item"/>
<colord cols="transid, account, store, date, sku, cost"/>
<willbe name="ceilcost" value="ceil(cost)"/>