对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。

$dateToString(表达式操作符)

$dateToString

根据用户指定的格式将日期对象转换为字符串。

$dateToString表达式采用以下运算符表达式语法:

可以使用 $dateToString 查找托管在以下环境中的部署:

  • MongoDB Atlas:用于云中 MongoDB 部署的完全托管服务

$dateToString 表达式采用以下操作符表达式语法:

{ $dateToString: { date: <dateExpression>, format: <formatString>, timezone: <tzExpression>, onNull: <expression>} }
字段
说明

date

要转换为字符串的日期。<dateExpression> 必须是解析为日期、时间戳或对象标识符的有效表达式。

format

可选。 日期格式规范。 <formatString> 可以是任何字符串,包含零个或多个格式说明符。 有关可用说明符的列表,请参阅格式说明符。

如果未指定,且指定了 timezone 并将设立为非 UTC 时区,则 $dateToString 会使用 "%Y-%m-%dT%H:%M:%S.%L" 作为默认格式。

如果未指定,且 timezone 未指定或明确指定为 UTC,则 $dateToString 使用 "%Y-%m-%dT%H:%M:%S.%LZ" 作为默认格式。

timezone

可选。操作结果的时区。<tzExpression> 必须是有效表达式,可解析为格式为Olson 时区标识符或UTC 偏移量的字符串。如果未提供 timezone,则结果采用 UTC 格式。

  • Olson Timezone Identifier:

    "America/New_York""Europe/London""GMT"
  • UTC Offset:

    +/-[hh]:[mm], e.g. "+04:45"+/-[hh][mm], e.g. "-0530"+/-[hh], e.g. "+03"

onNull

可选。当 date 为 null 或缺失时要返回的值。参数可以是任何有效的表达式。

如果未指定,则当 date 为 null 或缺失时,$dateToString 会返回 null。

<formatString> 中可使用以下格式说明符:

说明符
说明
Possible Values

%b

缩写月份名称(3 个字母)

7.0版本新增。

jan-dec

%B

完整月份名称

7.0版本新增。

january-december

%d

月中的某一天(2 位数字,补零)

01-31

%G

ISO 8601 格式的年份

0000-9999

%H

小时(2 位数字,填充零,24 小时时钟)

00-23

%j

年月日(3 位数字,填充零)

001-366

%L

毫秒(3 位数字,填充零)

000-999

%m

月份(2 位数字,补零)

01-12

%M

分钟(2 位数字,填充零)

00-59

%S

第二(2 位数字,补零)

00-60

%u

一周中每天的编号(采用 ISO 8601 格式,1-星期一,7-星期日)

1-7

%U

年中的某一周(2 位数字,补零)

00-53

%V

ISO 8601 格式的年中的某一周

01-53

%w

周中的某一天(1-星期日,7-星期六)

1-7

%Y

年份(4 位数字,补零)

0000-9999

%z

与 UTC 的时区偏移。

+/-[hh][mm]

%Z

从 UTC 开始偏移的分钟数。例如,如果时区偏移 (+/-[hhmm]) 为 +0445,则分钟偏移为 +285。

+/-mmm

%%

作为文本的百分比字符

%

使用以下文档创建 sales 集合:

db.sales.insertOne( { "_id" : 1, "item" : "abc", "price" : 10, "quantity" : 2, "date" : ISODate("2014-01-01T08:15:39.736Z") })

以下聚合使用$dateToString将date字段作为格式化字符串返回:

db.sales.aggregate( [ { $project: { yearMonthDayUTC: { $dateToString: { format: "%Y-%m-%d", date: "$date" } }, timewithOffsetNY: { $dateToString: { format: "%H:%M:%S:%L%z", date: "$date", timezone: "America/New_York"} }, timewithOffset430: { $dateToString: { format: "%H:%M:%S:%L%z", date: "$date", timezone: "+04:30" } }, minutesOffsetNY: { $dateToString: { format: "%Z", date: "$date", timezone: "America/New_York" } }, minutesOffset430: { $dateToString: { format: "%Z", date: "$date", timezone: "+04:30" } }, abbreviated_month: { $dateToString: {format: "%b", date: "$date", timezone: "+04:30" } }, full_month: { $dateToString: { format: "%B", date: "$date", timezone: "+04:30" } } } } ])

操作返回以下结果:

{ "_id" : 1, "yearMonthDayUTC" : "2014-01-01", "timewithOffsetNY" : "03:15:39:736-0500", "timewithOffset430" : "12:45:39:736+0430", "minutesOffsetNY" : "-300", "minutesOffset430" : "270", "abbreviated_month": "Jan", "full_month": "January"}
给本页内容打分