This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
dev:sql:functions:round [2009/12/07 14:43] tdo created |
dev:sql:functions:round [2016/10/15 04:48] (current) doc |
||
---|---|---|---|
Line 1: | Line 1: | ||
{{page>:top_add&nofooter&noeditbtn}} | {{page>:top_add&nofooter&noeditbtn}} | ||
- | <html><div align="center"><span style="color:red">DRAFT</span></div></html> | ||
- | ====== Omnidex SQL Function: CASE ====== | ||
{{page>:sql_bar&nofooter&noeditbtn}} | {{page>:sql_bar&nofooter&noeditbtn}} | ||
+ | ====== Omnidex SQL Function: ROUND ====== | ||
===== Description ===== | ===== Description ===== | ||
- | The $ROUND function returns a numeric expression rounded to a specified number of decimal places. | + | The ROUND function returns a numeric expression rounded to a specified number of decimal places. If the value specified by n is positive and longer than the digits after the decimal point, 0 is added after the fraction digits. If the value specified by n is negative and larger than or equal to the digits before the decimal point, 0.00 is returned. |
- | If the value specified by n is positive and longer than the digits after the decimal point, 0 is added after the fraction digits. | ||
- | |||
- | If the value specified by n is negative and larger than or equal to the digits before the decimal point, 0.00 is returned. | ||
===== Syntax ===== | ===== Syntax ===== | ||
- | $ROUND(expression [, n]) | ||
- | == expression == | + | ROUND(numeric_expression [, n]) |
+ | |||
+ | == numeric_expression == | ||
- | Required. A valid numerical value. This can be a column in a select statement that will return a numerical value. | + | Required. Any expression that returns a numeric expression. |
== n == | == n == | ||
- | Optional. n is an integer indicating the number of digits to the right of the decimal. The default is 0. | + | Optional. //n// is an integer indicating the number of digits to the right of the decimal. The default is 0. |
===== Example ===== | ===== Example ===== | ||
- | ==== Example 1 ==== | + | ==== Example 1: Column rounded to next higher integer ==== |
- | $ROUND(123.4545, 2) result: 123.4500 | + | |
+ | <code> | ||
+ | |||
+ | > select latitude, round(latitude) from countries; | ||
+ | |||
+ | LATITUDE ROUND(COUNTRIES.LATITUDE) | ||
+ | -------------------------------- -------------------------------- | ||
+ | 42.500000 43.000000 | ||
+ | 24.000000 24.000000 | ||
+ | 33.000000 33.000000 | ||
+ | 17.049999 17.000000 | ||
+ | 18.209999 18.000000 | ||
+ | 41.000000 41.000000 | ||
+ | 40.000000 40.000000 | ||
+ | </code> | ||
+ | |||
+ | ==== Example 2: Column rounded to a set number of decimal places ==== | ||
+ | |||
+ | Note that floating point values cannot represent ever value, and the values shown below are as close as floating point values can represent. | ||
+ | |||
+ | <code> | ||
+ | > select latitude, round(latitude, 1) from countries; | ||
- | $ROUND(123.4545, -2) result: 100.0000 | + | LATITUDE ROUND(COUNTRIES.LATITUDE,1) |
+ | -------------------------------- -------------------------------- | ||
+ | 42.500000 42.500000 | ||
+ | 24.000000 24.000000 | ||
+ | 33.000000 33.000000 | ||
+ | 17.049999 17.000000 | ||
+ | 18.209999 18.200001 | ||
+ | 41.000000 41.000000 | ||
+ | 40.000000 40.000000 | ||
+ | </code> | ||
- | $ROUND(123.9994, 3) result: 123.9990 | + | ====== Additional Resources ====== |
- | $ROUND(123.9995, 3) result: 124.0000 | + | See also: |
+ | {{page>dev:sql:functions:see_also_math&noheader&nofooter&noeditbtn}} | ||
{{page>:bottom_add&nofooter&noeditbtn}} | {{page>:bottom_add&nofooter&noeditbtn}} |