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
mod(X;Y)
Returns the modulo of two given values.

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.

`mod(X;Y)`

Returns the modulo of two given values.

Syntax

mod(X;Y)

Input

Argument	Type	Description
`X`	any numeric type	The dividend of the modulo operation
`Y`	any numeric type	The divisor of the modulo operation

Return Value

Returns a numeric value corresponding to X modulo Y.

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

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

Sample Usage


`X`	`Y`	`mod(X;Y)`
13	10	3 (integer)
9	3	0 (integer)
5.0	2.5	0 (decimal)
5	1.5	0.5 (decimal)
NA	1	0 (integer)
1.0	NA	NA (decimal)
NA	NA	NA (integer)

Example

In this example, the hour is displayed in 24-hour time (hour24only) and needs to be displayed as 12-hour time. The example uses the mod(X;Y) function to return the 12-hour time, which is the result of hour24only (X) modulo 12 (Y).

<base table="pub.doc.retail.salesdetail"/>
<colord cols="transid, trans_date, tme"/>
<willbe name="hour24only" value="hour(tme)"/>
<willbe name="hour12mod" value="mod(hour24only;12)"/>
<sel value="0.0001" sample="1"/>

Note: <sel value="0.0001" sample="1"/> selects a random sample of 1/10,000th of the data.