跳到主要内容
版本: 最新版本-3.5

mod

模数函数,返回 dividend 除以 divisor 的余数。

语法

mod(dividend, divisor)

参数

  • dividend: 被除数。
  • divisor: 除数。

dividenddivisor 均支持以下数据类型

  • TINYINT
  • SMALLINT
  • INT
  • BIGINT
  • LARGEINT
  • FLOAT
  • DOUBLE
  • DECIMALV2
  • DECIMAL32
  • DECIMAL64
  • DECIMAL128

注意

dividenddivisor 的数据类型必须一致。 如果数据类型不一致,StarRocks 会执行隐式转换。

返回值

返回与 dividend 相同数据类型的值。 如果 divisor 指定为 0,StarRocks 将返回 NULL。

示例

mysql> select mod(3.14,3.14);
+-----------------+
| mod(3.14, 3.14) |
+-----------------+
| 0 |
+-----------------+

mysql> select mod(3.14, 3);
+--------------+
| mod(3.14, 3) |
+--------------+
| 0.14 |
+--------------+

select mod(11,-5);
+------------+
| mod(11, -5)|
+------------+
| 1 |
+------------+

select mod(-11,5);
+-------------+
| mod(-11, 5) |
+-------------+
| -1 |
+-------------+