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
round(X;Y)
Returns the result of rounding the first given value to the nearest multiple of the second given value.

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.

`round(X;Y)`

Returns the result of rounding the first given value to the nearest multiple of the second given value.

Syntax

round(X;Y)

Input

Argument	Type	Description
`X`	any numeric type	The number to round to the nearest multiple of `Y`
`Y`	any numeric type	The nearest multiple to round `X`

Return Value

Returns a numeric value corresponding to X rounded to the nearest multiple of Y.

If both X and Y are integers, the result is an integer; otherwise, the result is a decimal number.

If X and/or Y is N/A, the result is N/A.

round(X;Y) can also round time into intervals. If X and Y are in the format 'HH:MM:SS', the result is the time rounded up to the next time interval specified in Y. Y must be written as a string (single quotes).

Sample Usage


`X`	`Y`	`round(X;Y)`
149.456	0.01	149.46 (decimal)
149.456	1	149 (decimal)
149.456	0.05	149.45 (decimal)
149.456	5	150 (decimal)
7	5	5 (integer)
8	5	10 (integer)
8.0	5	10 (decimal)
NA	1	NA (integer)
1.0	NA	NA (decimal)
NA	NA	NA (integer)

Example

In this example, the round(X;Y) function returns the value of the dewptm (X) rounded to the nearest multiple of Y, which is 1, on thepub.demo.weather.wunderground.observed_hourly table.

<base table="pub.demo.weather.wunderground.observed_hourly"/>
<colord cols="zipcode, date, tempm, dewptm"/>
<willbe name="round_dewptm" value="round(dewptm;1)"/>

Example

In the following example, round(X;Y) rounds the time in tme (X) into 10-minute intervals (Y is '00:10:00') in the pub.doc.retail.salesdetail table for a specific store and date. Note that Y is written as a string (single quotes) and the time format is hms24 (24-hour).

<note type="base">Applied to table: pub.doc.retail.salesdetail</note>
<base table="pub.doc.retail.salesdetail"/>
<sel value="(store=3)"/>
<sel value="(trans_date=20150112)"/>
<willbe name="interval" value="round(tme;'00:10:00')" format="type:hms24"/>
<colord cols="date, tme, xsales, interval"/>

You can then perform a tabulation to find the total sales for each 10-minute interval.

<tabu label="Tabulation on Sales Detail" breaks="interval">
 <tcol source="xsales" fun="sum" label="Sum of`Extended`Sales"/>
</tabu>