$dateToString
聚合运算符按用户指定的格式将日期对象转为字符串。
语法
{
$dateToString: {
date: <dateExpression>,
format: <formatString>,
timezone: <tzExpression>,
onNull: <expression>
} }
字段说明:
字段 | 是否必须 | 描述 |
---|---|---|
date |
是 | <dateExpression> 可以是日期、时间戳或对象Id表达式 |
format |
否 | 日期格式,<formatString> 可以是任何字符串,包含0个或多个格式指示符 |
timezone |
否 | 执行操作的时区,<tzExpression> 必须是能被解析为奥尔森时区标识符格式的字符串或UTC偏移量,如果timezone 不指定,返回值显示为UTC |
onNull |
否 | 当date 为空或缺失时的返回值。参数可以是任何有效的表达式。如果未指定$dateToString 会在date 为null 或缺失时返回null 。 |
使用
格式指示符
<formatString>
格式指示符可以是下面的值:
指示符 | 描述 | 可能的值 |
---|---|---|
%b | 月份缩写(3个字符) | jan , feb , mar , apr , may , jun , jul , aug , sep , oct , nov , dec |
%B | 完整月份 | january -december |
%d | 一个月内的第几天(2个数字,0填充) | 01 -31 |
%G | ISO8601格 |