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
between(X;Y;Z)
Returns a boolean value indicating whether a given value is between two other 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.

`between(X;Y;Z)`

Returns a boolean value indicating whether a given value is between two other values.

Syntax

between(X;Y;Z)

Input

Argument	Type	Description
`X`	any simple type	The value to test within the range defined by `Y` and `Z`
`Y`	any simple type	The minimum value of the range in which to check for `X` Note: The order of `Y` and `Z` doesn't matter. If `Y` is the name of a column, `Z` must also be the name of a column.
`Z`	any simple type	The maximum value of the range in which to check for `X` Note: The order of `Y` and `Z` doesn't matter. If `Z` is the name of a column, `Y` must also be the name of a column.

Note: All arguments must be of the same type. This function is most commonly used with numeric values; however, if strings are provided as arguments, the comparison is done as a binary string comparison.

Return Value

Returns an integer value of 1 if either:

X>=Y and X<=Z
X>=Z and X<=Y

Returns a 0, otherwise.

If X is N/A, the result is 0, unless either Y or Z (or both) are N/A, in which case the result is 1.

If X, Y, and Z are not either all numeric values or all string values, an error is returned.

Sample Usage


`value`	`begin`	`end`	`between(value;begin;end)`
2	1	3	1
2	3	1	1
1.5	1	3	1
1.5	2.5	3.1	0
1.5	1.2	3.1	1
'bat'	'bar'	'baz'	1
'bag'	'bar'	'baz'	0
'foo'	'bar'	'baz'	0
	1	3	0
	1		1

Example

In the "Sales Item Detail" table (pub.demo.retail.item), you can find only those rows whose values in the Sales column fall between 1 and 2.25. To do this, create a computed column and apply the between(X;Y;Z) function to the sales column, where Y is 1 and Z is 2.25:

<note type="base">Applied to table: pub.demo.retail.item</note>
<willbe name="between_result" value="between(sales;1;2.25)"/>

For those values in the sales column that fall between 1 and 2.25, the result is 1. Otherwise, the result is 0.