注意:
有关特定运算符的详细信息,包括语法和示例,请单击特定运算符以转到其参考页。
表达式运算符
在这个部分
- 算术表达式运算符
- 列表表达式运算符
- 布尔表达式运算符
- 比较表达式运算符
- 条件表达式运算符
- 日期表达式运算符
- 文字表达式运算符
- 对象表达式运算符
- 集合表达式运算符
- 字符串表达式运算符
- 文本表达式运算符
- 三角表达式运算符
- 类型表达式运算符
- 累加器($group)
- 累加器(处于其他阶段)
- 变量表达式运算符
运算符表达式类似于带有参数的函数。通常,这些表达式采用参数数组并具有以下形式:
{ <operator>: [ <argument1>, <argument2> ... ] }
如果 operator 接受单个参数,可以省略指定参数列表的外部数组:
{ <operator>: <argument> }
为了避免在参数是文字数组的情况下解析歧义,必须将文字数组包装在$literal表达式中,或者保留指定参数列表的外部数组。
算术表达式运算符
算术表达式对 numbers 执行数学运算。一些算术表达式也可以支持 date 算术。
| 名称 | 描述 |
|---|---|
| $abs | 返回数字的绝对 value。 |
| $add | 添加 numbers 以 return 总和,或添加 numbers 和 date 以 return 新的 date。如果添加 numbers 和 date,则将 numbers 视为毫秒。接受任意数量的参数表达式,但最多只能有一个表达式解析为 date。 |
| $ceil | 返回大于或等于指定数字的最小 integer。 |
| $divide | 返回将第一个数除以第二个数的结果。接受两个参数表达式。 |
| $exp | 将 e 提高到指定的指数。 |
| $floor | 返回小于或等于指定数字的最大 integer。 |
| $ln | 计算数字的自然 log。 |
| $log | 计算指定基数中的数字的 log。 |
| $log10 | 计算数字的 log 基数 10。 |
| $mod | 返回第一个数字的余数除以第二个数字。接受两个参数表达式。 |
| $multiply | 将 numbers 乘以_return 产品。接受任意数量的参数表达式。 |
| $pow | 将数字提高到指定的指数。 |
| $round | 将数字四舍五入为整数或指定的小数位。 |
| $sqrt | 计算平方根。 |
| $subtract | 返回从第一个中减去第二个 value 的结果。如果这两个值是 numbers,返回差异。如果这两个值是日期,则返回差异(以毫秒为单位)。如果这两个值是 date 和一个以毫秒为单位的数字,_return 结果 date。接受两个参数表达式。如果这两个值是 date 和数字,请首先指定 date 参数,因为从数字中减去 date 没有意义。 |
| $trunc | 截断其整数的数字。 |
列表表达式运算符
| 名称 | 描述 |
|---|---|
| $arrayElemAt | 返回指定的数组索引处的元素。 |
| $arrayToObject | 将键值对的数组转换为文档。 |
| $concatArrays | 连接数组以返回连接的数组。 |
| $filter | 选择数组的子集以返回仅包含与过滤条件匹配的元素的数组。 |
| $in | 返回一个布尔值,指示指定的值是否在数组中。 |
| $indexOfArray | 在数组中搜索指定值的出现,并返回第一个出现的数组索引。如果未找到子字符串,则返回-1。 |
| $isArray | 确定操作数是否为数组。返回一个布尔值。 |
| $map | 对数组的每个元素应用子表达式,并按顺序返回结果值的数组。接受命名参数。 |
| $objectToArray | 将文档转换为代表键值对的文档数组。 |
| $range | 根据用户定义的输入输出包含整数序列的数组。 |
| $reduce | 将表达式应用于数组中的每个元素,并将它们组合为单个值。 |
| $reverseArray | 返回具有相反顺序元素的数组。 |
| $size | 返回数组中元素的数量。接受单个表达式作为参数。 |
| $slice | 返回数组的子集。 |
| $zip | 合并两个数组。 |
布尔表达式运算符
布尔表达式将其参数表达式计算为布尔值,并返回布尔值作为结果。
除了false布尔值,布尔表达式为false如下:null,0,和undefined 的值。布尔表达式将所有其他值评估为true,包括非零数字值和数组。
| 名称 | 描述 |
|---|---|
| $and | 仅当其所有表达式求值为true时才返回true。接受任意数量的参数表达式。 |
| $not | 返回与其参数表达式相反的 boolean value。接受单个参数表达式。 |
| $or | 当任何表达式求值为true时返回true。接受任意数量的参数表达式。 |
比较表达式运算符
比较表达式返回一个布尔值,但$cmp返回一个数字。
比较表达式采用两个参数表达式并比较 value 和 type,使用指定的 BSON 比较顺序表示不同类型的值。
| 名称 | 描述 |
|---|---|
| $cmp | 如果两个值相等则返回0,如果第一个 value 大于第二个值则返回1,如果第一个 value 小于第二个值,则返回-1。 |
| $eq | 如果值相等,则返回true。 |
| $gt | 如果第一个 value 大于第二个,则返回true。 |
| $gte | 如果第一个 value 大于或等于第二个,则返回true。 |
| $lt | 如果第一个 value 小于第二个,则返回true。 |
| $lte | 如果第一个 value 小于或等于第二个值,则返回true。 |
| $ne | 如果值不相等,则返回true。 |
条件表达式运算符
| 名称 | 描述 |
|---|---|
| $cond | 一个三元运算符,它计算一个表达式,并根据结果返回另外两个表达式之一的值。接受有序列表中的三个表达式或三个命名参数。 |
| $ifNull | 如果第一个表达式导致结果为null ,则返回第一个表达式的非空结果或第二个表达式的结果。空结果包含未定义值或缺少字段的实例。接受两个表达式作为参数。第二个表达式的结果可以为 null。 |
| $switch | 计算一系列案例表达式。当它找到一个计算结果为true的表达式时,$switch执行一个指定的表达式并退出控制流。 |
日期表达式运算符
以下运算符返回日期对象或日期对象的组成部分:
| 名称 | 描述 |
|---|---|
| $dateFromParts | 给出日期的组成部分,构造一个 BSON Date对象。 |
| $dateFromString | 将 date/time 字符串转换为 date 对象。 |
| $dateToParts | 返回包含 date 组成部分的文档。 |
| $dateToString | 将 date 作为格式化的 string 返回。 |
| $dayOfMonth | 将 date 的月中某天返回为 1 到 31 之间的数字。 |
| $dayOfWeek | 将 date 的星期几返回为 1(星期日)和 7(星期六)之间的数字。 |
| $dayOfYear | 将 date 的年中日期作为 1 到 366(闰年)之间的数字返回。 |
| $hour | 将 date 的小时数作为 0 到 23 之间的数字返回。 |
| $isoDayOfWeek | 返回 ISO 8601 格式的工作日编号,范围从1(星期一)到7(星期日)。 |
| $isoWeek | 返回 ISO 8601 格式的周数,范围从1到53。 星期数从1开始,周(星期一到星期日)包含年份的第一个星期四。 |
| $isoWeekYear | 以 ISO 8601 格式返回年份编号。年份从第 1 周的星期一(ISO 8601)开始,结束于上周的星期日(ISO 8601)。 |
| $millisecond | 返回 date 的毫秒数,作为 0 到 999 之间的数字。 |
| $minute | 将 date 的分钟作为 0 到 59 之间的数字返回。 |
| $month | 将 date 的月份返回为 1(1 月)和 12(12 月)之间的数字。 |
| $second | 返回 date 的秒数,作为 0 到 60 之间的数字(闰秒)。 |
| $toDate | 将值转换为日期。 版本4.0中的新功能。 |
| $week | 返回 date 的周数,作为 0(在一年的第一个星期日之前的部分周)和 53(闰年)之间的数字。 |
| $year | 将 date 的年份作为数字返回(例:2014)。 |
以下算术运算符可以使用 date 操作数:
| 名称 | 描述 |
|---|---|
| $add | 添加 numbers 和 date 以返回新的 date。如果添加 numbers 和 date,则将 numbers 视为毫秒。接受任意数量的参数表达式,但最多只能有一个表达式解析为 date。 |
| $subtract | 返回从第一个中减去第二个值的结果。如果这两个值是日期,则返回差异(以毫秒为单位)。如果这两个值是 date 和一个以毫秒为单位的数字,返回结果 date。接受两个参数表达式。如果这两个值是 date 和数字,请首先指定 date 参数,因为从数字中减去 date 没有意义。 |
文字表达式运算符
| 名称 | 描述 |
|---|---|
| $literal | 无需解析即可返回 value。用于聚合管道可以将其解释为表达式的值。例如,对以$开头的字符串使用]$literal表达式,以避免解析为字段路径。 |
对象表达式运算符
| 名称 | 描述 |
|---|---|
| $mergeObjects | 将多个文档合并为一个文档。 version 3.6 中的新内容。 |
| $objectToArray | 将文档转换为表示 key-value 对的文档的 array。 version 3.6 中的新内容。 |
集合表达式运算符
Set 表达式对数组执行 set 操作,将数组视为 sets。 Set 表达式忽略每个输入数组中的重复条目和元素的顺序。
如果 set 操作返回一个 set,则该操作会过滤掉结果中的重复项,以输出仅包含唯一条目的 array。输出 array 中元素的顺序未指定。
如果集合包含嵌套的 array 元素,则 set 表达式不会下降到嵌套的 array 中,而是在顶层level 处计算 array。
| 名称 | 描述 |
|---|---|
| $allElementsTrue | 如果没有集合的元素计算为false,则返回true,否则返回false。接受单个参数表达式。 |
| $anyElementTrue | 如果集合中的任何元素求值为true,则返回true;否则,返回false。接受单个参数表达式。 |
| $setDifference | 返回一个集合,其中的元素出现在第一个集合中但不出现在第二个集合中; 即:相对于第一组执行第二组的相对补充。接受两个参数表达式。 |
| $setEquals | 如果输入 sets 具有相同的不同元素,则返回true。接受两个或多个参数表达式。 |
| $setIntersection | 返回一个包含所有输入 sets 中出现的元素的集合。接受任意数量的参数表达式。 |
| $setIsSubset | 如果第一组的所有元素出现在第二组中,则返回true,包括第一组的等于第二组的时间; 即:不是严格的子集。接受两个参数表达式。 |
| $setUnion | 返回一个包含任何输入 sets 中出现的元素的集合。 |
字符串表达式运算符
字符串表达式(除外 $concat)仅对ASCII字符字符串具有明确定义的行为。
$concat 行为是明确定义的,与所使用的字符无关。
| 名称 | 描述 |
|---|---|
| $concat | 连接任意数量的 strings。 |
| $dateFromString | 将 date/time string 转换为 date object。 |
| $dateToString | 将 date 作为格式化的 string 返回。 |
| $indexOfBytes | 搜索 string 以查找子字符串的出现并返回第一次出现的 UTF-8 字节索引。如果未找到子字符串,则返回-1。 |
| $indexOfCP | 搜索 string 以查找子字符串的出现并返回第一次出现的 UTF-8 code 点索引。如果找不到子字符串,则返回-1 |
| $ltrim | 从字符串开头删除空格或指定的字符。 版本4.0中的新功能。 |
| $regexFind | 将正则表达式(regex)应用于字符串,并返回第一个匹配的子字符串的信息。 4.2版中的新功能。 |
| $regexFindAll | 将正则表达式(regex)应用于字符串,并返回所有匹配的子字符串的信息。 4.2版中的新功能。 |
| $regexMatch | 将正则表达式(regex)应用于字符串,并返回一个布尔值,该布尔值指示是否找到匹配项。 4.2版中的新功能。 |
| $rtrim | 从字符串末尾删除空格或指定的字符。 版本4.0中的新功能。 |
| $split | 根据分隔符将 string 拆分为子字符串。返回子字符串的 array。如果在 string 中找不到分隔符,则返回包含原始 string 的 array。 |
| $strLenBytes | 返回 string 中 UTF-8 编码字节的数量。 |
| $strLenCP | 返回 string 中 UTF-8 code 点的数量。 |
| $strcasecmp | 执行 case-insensitive string 比较并返回:如果两个 strings 相等则返回0,如果第一个 string 大于第二个,则返回1,如果第一个 string 小于第二个,则返回-1。 |
| $substr | 已过时。使用$substrBytes或$substrCP。 |
| $substrBytes | 返回 string 的子字符串。从 string 中指定的 UTF-8 字节索引(zero-based)处的字符开始,并继续指定的字节数。 |
| $substrCP | 返回 string 的子字符串。从 string 中指定的 UTF-8 code point(CP)索引(zero-based)处的字符开始,并继续指定的 code 点数。 |
| $toLower | 将 string 转换为小写。接受单个参数表达式。 |
| $toString | 将值转换为字符串。 版本4.0中的新功能。 |
| $trim | 从字符串的开头和结尾删除空格或指定的字符。 版本4.0中的新功能。 |
| $toUpper | 将 string 转换为大写。接受单个参数表达式。 |
文本表达式运算符
| 名称 | 描述 |
|---|---|
| $meta | 访问文本搜索元数据。 |
三角表达式运算符
三角表达式对数字执行三角运算。表示角度的值始终以弧度为单位输入或输出。使用 $degreesToRadians和$radiansToDegrees在度和弧度测量之间转换。
| 名称 | 描述 |
|---|---|
| $sin | 返回以弧度为单位的值的正弦值。 |
| $cos | 返回以弧度为单位的值的余弦值。 |
| $tan | 返回以弧度为单位的值的切线。 |
| $asin | 返回弧度值的反正弦(弧正弦)。 |
| $acos | 返回弧度值的反余弦(弧余弦)。 |
| $atan | 返回弧度值的反正切(弧切)。 |
| $atan2 | 返回弧度表示的y / x的反正切(弧切线),其中y和x是分别传递给表达式的第一个和第二个值。 |
| $asinh | 返回弧度值的反双曲正弦(双曲反正弦)。 |
| $acosh | 返回弧度值的反双曲余弦(双曲反余弦)。 |
| $atanh | 返回弧度值的反双曲正切(双曲反正切)。 |
| $degreesToRadians | 将值从度转换为弧度。 |
| $radiansToDegrees | 将值从弧度转换为度。 |
类型表达式运算符
| 名称 | 描述 |
|---|---|
| $convert | 将值转换为指定的类型。 版本4.0中的新功能。 |
| $toBool | 将值转换为布尔值。 版本4.0中的新功能。 |
| $toDate | 将值转换为日期。 版本4.0中的新功能。 |
| $toDecimal | 将值转换为Decimal128。 版本4.0中的新功能。 |
| $toDouble | 将值转换为双精度。 版本4.0中的新功能。 |
| $toInt | 将值转换为整数。 版本4.0中的新功能。 |
| $toLong | 将值转换为long。 版本4.0中的新功能。 |
| $toObjectId | 将值转换为ObjectId。 版本4.0中的新功能。 |
| $toString | 将值转换为字符串。 版本4.0中的新功能。 |
| $type | 返回该字段的BSON数据类型。 |
累加器($group)
累加器是可以在$group阶段使用的运算符,它们在文档通过管道时保持其状态(例如: 总计,最大值,最小值和相关数据)。
当在$group阶段用作累加器时,这些运算符将单个表达式作为输入,为每个输入文档计算一次表达式,并为共享相同 group key 的 group 文档保持其阶段。
| 名称 | 描述 |
|---|---|
| $addToSet | 返回每个 group 的唯一表达式值的 array。 数组元素的顺序是未定义的。 |
| $avg | 返回数值的平均值。忽略非数字值。 |
| $first | 从每个 group 的第一个文档返回一个值。仅当文档按定义的顺序定义顺序。 |
| $last | 从每个 group 的最后一个文档返回一个值。仅当文档按定义的顺序定义顺序。 |
| $max | 返回每个 group 的最高表达式值。 |
| $mergeObjects | 返回通过组合每个 group 的输入文档创建的文档。 |
| $min | 返回每个 group 的最低表达式值。 |
| $push | 返回每个 group 的表达式值的 array。 |
| $stdDevPop | 返回输入值的总体标准偏差。 |
| $stdDevSamp | 返回输入值的 sample 标准偏差。 |
| $sum | 返回数值的总和。忽略非数字值。 |
累加器(处于其他阶段)
一些可用作$group阶段累加器的运算符也可用于$project阶段,但不能用作累加器。在$project阶段使用时,这些 operator 不会维护它们的 state,并且可以将单个参数或多个 arguments 作为输入。
更改了 version 3.2.
以下累加器 operators 也可用于$project、$addFields和$set阶段。
| 名称 | 描述 |
|---|---|
| $avg | 返回每个文档的指定表达式或表达式列表的平均值。忽略非数字值。 |
| $max | 返回每个文档的指定表达式或表达式列表的最大值。 |
| $min | 返回每个文档的指定表达式或表达式列表的最小值。 |
| $stdDevPop | 返回输入值的总体标准偏差。 |
| $stdDevSamp | 返回输入值的样本标准偏差。 |
| $sum | 返回数值的总和。忽略非数字值。 |
变量表达式运算符
| 名称 | 描述 |
|---|---|
| $let | 定义在子表达式范围内使用的变量,并返回子表达式的结果。接受命名参数。 接受任意数量的参数表达式。 |
表达式运算符的字母顺序列表
| 名称 | 描述 |
|---|---|
| $abs | 返回数字的绝对值。 |
| $acos | 返回弧度值的反余弦(弧余弦)。 |
| $acosh | 返回弧度值的反双曲余弦(双曲反余弦)。 |
| $add | 添加数字以返回总和,或者添加数字和日期以返回新日期。如果添加数字和日期,则将数字视为毫秒。接受任意数量的参数表达式,但最多只能一个表达式解析为日期。 |
| $addToSet | 返回每个 group 的唯一表达式值的 array。 数组元素的顺序是未定义的。 仅适用于$group阶段 |
| $allElementsTrue | 如果没有集合的元素计算为false,则返回true,否则返回false。接受单个参数表达式。 |
| $and | 仅当其所有表达式求值为true时才返回true。接受任意数量的参数表达式。 |
| $anyElementTrue | 如果集合中的任何元素求值为true,则返回true;否则,返回false。接受单个参数表达式。 |
| $arrayElemAt | 返回指定的 array 索引处的元素。 |
| $arrayToObject | 将键值对的 array 转换为文档。 |
| $asin | 返回弧度值的反正弦(弧正弦)。 |
| $asinh | 返回弧度值的反双曲正弦(双曲反正弦)。 |
| $atan | 返回弧度值的反正切(弧切)。 |
| $atan2 | 返回弧度表示的y / x的反正切(弧切线),其中y和x是分别传递给表达式的第一个和第二个值。 |
| $atanh | 返回弧度值的反双曲正切(双曲反正切)。 |
| $avg | 返回数值的平均值。忽略非数字值。 在 version 3.2 中更改:在$group和$project阶段均可用。 |
| $ceil | 返回大于或等于指定数字的最小整数。 |
| $cmp | 如果两个值相等则返回0,如果第一个 value 大于第二个值则返回1,如果第一个 value 小于第二个值,则返回-1。 |
| $concat | 连接任意数量的字符串。 |
| $concatArrays | 连接数组以返回连接的数组。 |
| $cond | 一个三元运算符,它计算一个表达式,并根据结果返回另外两个表达式之一的值。接受有序列表中的三个表达式或三个命名参数。 |
| $convert | 将值转换为指定的类型。 |
| $cos | 返回以弧度为单位的值的余弦值。 |
| $dateFromParts | 给出 date 的组成部分,构造一个 BSON Date对象。 |
| $dateToParts | 返回包含 date 组成部分的文档。 |
| $dateFromString | 返回 date/time 作为 date 对象。 |
| $dateToString | 将 date 作为格式化的 string 返回。 |
| $dayOfMonth | 将 date 的月中某天返回为 1 到 31 之间的数字。 |
| $dayOfWeek | 将 date 的星期几返回为 1(星期日)和 7(星期六)之间的数字。 |
| $dayOfYear | 将 date 的年中日期作为 1 到 366(闰年)之间的数字返回。 |
| $degreesToRadians | 将值从度转换为弧度。 |
| $divide | 返回将第一个数除以第二个数的结果。接受两个参数表达式。 |
| $eq | 如果值相等,则返回true。 |
| $exp | 将 e 提高到指定的指数。 |
| $filter | 选择 array 的子集以返回 array 仅包含 match 过滤条件的元素。 |
| $first | 从每个 group 的第一个文档返回一个 value。仅当文档位于已定义的 order 中时才定义 Order。 仅适用于$group阶段。 |
| $floor | 返回小于或等于指定数字的最大 integer。 |
| $gt | 如果第一个 value 大于第二个,则返回true。 |
| $gte | 如果第一个 value 大于或等于第二个,则返回true。 |
| $hour | 将 date 的小时数作为 0 到 23 之间的数字返回。 |
| $ifNull | 如果第一个表达式导致 null 结果,则返回第一个表达式的 non-null 结果或第二个表达式的结果。空结果包含未定义值或缺少字段的实例。接受两个表达式作为参数。第二个表达式的结果可以为 null。 |
| $in | 返回一个 boolean,指示指定的 value 是否在 array 中。 |
| $indexOfArray | 搜索 array 以查找指定 value 的出现并返回第一次出现的 array 索引。如果未找到子字符串,则返回-1。 |
| $indexOfBytes | 搜索 string 以查找子字符串的出现并返回第一次出现的 UTF-8 字节索引。如果未找到子字符串,则返回-1。 |
| $indexOfCP | 搜索 string 以查找子字符串的出现并返回第一次出现的 UTF-8 code 点索引。如果未找到子字符串,则返回-1。 |
| $isArray | 确定操作数是否为 array。返回 boolean。 |
| $isoDayOfWeek | 返回 ISO 8601 格式的工作日编号,范围从1(星期一)到7(星期日)。 |
| $isoWeek | 返回 ISO 8601 格式的周数,范围从1到53。 Week numbers 从1开始,周(星期一到星期日)包含年份的第一个星期四。 |
| $isoWeekYear | 以 ISO 8601 格式返回年份编号。年份从第 1 周的星期一(ISO 8601)开始,结束于上周的星期日(ISO 8601)。 |
| $last | 从每个 group 的最后一个文档返回一个 value。仅当文档位于已定义的 order 中时才定义 Order。 仅适用于$group阶段。 |
| $let | 定义在子表达式范围内使用的变量,并返回子表达式的结果。接受命名参数。 接受任意数量的参数表达式。 |
| $literal | 无需解析即可返回 value。用于聚合管道可以将其解释为表达式的值。例如,对以$开头的字符串使用$literal表达式,以避免解析为字段路径。 |
| $ln | 计算数字的自然对数。 |
| $log | 计算指定基数中的数字的对数。 |
| $log10 | 计算数字的以10为底的对数。 |
| $lt | 如果第一个 value 小于第二个,则返回true。 |
| $lte | 如果第一个 value 小于或等于第二个值,则返回true。 |
| $ltrim | 从字符串开头删除空格或指定的字符。 |
| $map | 将子表达式应用于 array 的每个元素,并按顺序返回结果值的 array。接受命名参数。 |
| $max | 返回每个 group 的最高表达式 value。 在 version 3.2 中更改:在$group和$project阶段均可用。 |
| $mergeObjects | 将多个文档合并为一个文档。 |
| $meta | 访问文本搜索元数据。 |
| $min | 返回每个 group 的最低表达式 value。 在 version 3.2 中更改:在$group和$project阶段均可用。 |
| $millisecond | 返回 date 的毫秒数,作为 0 到 999 之间的数字。 |
| $minute | 将 date 的分钟作为 0 到 59 之间的数字返回。 |
| $mod | 返回第一个数字的余数除以第二个数字。接受两个参数表达式。 |
| $month | 将 date 的月份返回为 1(1 月)和 12(12 月)之间的数字。 |
| $multiply | 乘以数字可返回乘积。接受任意数量的参数表达式。 |
| $ne | 如果值不相等,则返回true。 |
| $not | 返回与其参数表达式相反的布尔值。接受单个参数表达式。 |
| $objectToArray | 将文档转换为表示键值对的文档的 array。 |
| $or | 当任何表达式求值为true时返回true。接受任意数量的参数表达式。 |
| $pow | 将数字提高到指定的指数。 |
| $push | 返回每个 group 的表达式值的 array。 仅适用于$group阶段。 |
| $range | 根据用户定义输入输出包含整数序列的 array。 |
| $reduce | 将表达式应用于 array 中的每个元素,并将它们组合为单个 value。 |
| $regexFind | 将正则表达式(regex)应用于字符串,并返回第一个匹配的子字符串的信息。 |
| $regexFindAll | 将正则表达式(regex)应用于字符串,并返回所有匹配的子字符串的信息。 |
| $regexMatch | 将正则表达式(regex)应用于字符串,并返回一个布尔值,该布尔值指示是否找到匹配项。 |
| $reverseArray | 返回具有相反顺序元素的 array。 |
| $round | 将数字四舍五入为整数或指定的小数位。 |
| $rtrim | 从字符串末尾删除空格或指定的字符。 |
| $second | 返回 date 的秒数,作为 0 到 60 之间的数字(闰秒)。 |
| $setDifference | 返回一个集合,其中的元素出现在第一个集合中但不出现在第二个集合中; 即:相对于第一组执行第二组的相对补充)。接受两个参数表达式。 |
| $setEquals | 如果输入集合具有相同的不同元素,则返回true。接受两个或多个参数表达式。 |
| $setIntersection | 返回一个包含所有输入集合中出现的元素的集合。接受任意数量的参数表达式。 |
| $setIsSubset | 如果第一组的所有元素出现在第二组中,则返回true,包括第一组的等于第二组的时间; 即:不是严格的子集。接受两个参数表达式。 |
| $setUnion | 返回一个包含任何输入集合中出现的元素的集合。 |
| $size | 返回 array 中的元素数。接受单个表达式作为参数。 |
| $sin | 返回以弧度为单位的值的正弦值。 |
| $slice | 返回 array 的子集。 |
| $split | 根据分隔符将 string 拆分为子字符串。返回子字符串的 array。如果在 string 中找不到分隔符,则返回包含原始 string 的 array。 |
| $sqrt | 计算平方根。 |
| $stdDevPop | 返回输入值的总体标准偏差。 在 version 3.2 中更改:在$group和$project阶段均可用。 |
| $stdDevSamp | 返回输入值的样本标准偏差。 在 version 3.2 中更改:在$group和$project阶段均可用。 |
| $strcasecmp | 执行不区分大小写的字符串比较并返回:如果两个字符串相等则返回0,如果第一个字符串大于第二个,则返回1,如果第一个字符串小于第二个,则返回-1。 |
| $strLenBytes | 返回 string 中 UTF-8 编码字节的数量。 |
| $strLenCP | 返回 string 中 UTF-8 code 点的数量。 |
| $substr | 已过时。使用$substrBytes或$substrCP。 |
| $substrBytes | 返回 string 的子字符串。从 string 中指定的 UTF-8 字节索引(从零开始)处的字符开始,并继续指定的字节数。 |
| $substrCP | 返回 string 的子字符串。从 string 中指定的 UTF-8 code point(CP)索引(从零开始)处的字符开始,并继续指定的 code 点数 |
| $subtract | 返回从第一个中减去第二个 value 的结果。如果这两个值是数字,返回差值。如果这两个值是日期,则返回差值(以毫秒为单位)。如果这两个值是 date 和一个以毫秒为单位的数字,则返回结果 date。接受两个参数表达式。如果这两个值是 date 和数字,请首先指定 date 参数,因为从数字中减去 date 没有意义。 |
| $sum | 返回数值的总和。忽略非数字值。 在 version 3.2 中更改:在$group和$project阶段均可用。 |
| $switch | 计算一系列案例表达。当它找到一个计算结果为true的表达式时,$switch执行一个指定的表达式并退出控制流。 |
| $tan | 返回以弧度为单位的值的切线。 |
| $toBool | 将值转换为布尔值。 |
| $toDate | 将值转换为日期。 |
| $toDecimal | 将值转换为Decimal128。 |
| $toDouble | 将值转换为双精度。 |
| $toInt | 将值转换为整数。 |
| $toLong | 将值转换为long。 |
| $toObjectId | 将值转换为ObjectId。 |
| $toString | 将值转换为字符串。 |
| $toLower | 将 string 转换为小写。接受单个参数表达式。 |
| $toUpper | 将 string 转换为大写。接受单个参数表达式。 |
| $trim | 从字符串的开头和结尾删除空格或指定的字符。 |
| $trunc | 截断其整数的数字。 |
| $type | 返回该字段的 BSON 数据类型。 |
| $week | 返回 date 的周数,作为 0(在一年的第一个星期日之前的部分周)和 53(闰年)之间的数字。 |
| $year | 将 date 的年份作为数字返回(例:2014)。 |
| $zip | 将两个数组合并在一起。 |
对于管道阶段,请参见聚合管道阶段。
译者:李冠飞
校对: