跳到主要内容

Aggregate.dateToString

1. 操作符描述​

功能：将一个日期/时间字符串转换为日期对象

声明：db.command.aggregate.dateToString({date: <日期表达式>,format: <格式化表达式>,timezone: <时区表达式>,onNull: <空值表达式> })

2. 操作符参数​

字段类型必填说明
datestring是日期表达式
formatstring否格式化表达式
timezonestring否时区表达式
onNullstring否空值表达式

下面是四种表达式的详细说明：

名称描述
日期表达式必选。指定字段值应该是能转化为字符串的日期。
格式化表达式可选。它可以是任何包含“格式说明符”的有效字符串。
时区表达式可选。指明运算结果的时区。它可以解析格式为 UTC Offset 或者 Olson Timezone Identifier 的字符串。
空值表达式可选。当 <日期表达式> 返回空或者不存在的时候，会返回此表达式指明的值。

下面是格式说明符的详细说明：

说明符描述合法值
%d月份的日期（2 位数，0 填充）01 - 31
%GISO 8601 格式的年份0000 - 9999
%H小时（2 位数，0 填充，24 小时制）00 - 23
%j一年中的一天（3 位数，0 填充）001 - 366
%L毫秒（3 位数，0 填充）000 - 999
%m月份（2 位数，0 填充）01 - 12
%M分钟（2 位数，0 填充）00 - 59
%S秒（2 位数，0 填充）00 - 60
%w星期几1 - 7
%uISO 8601 格式的星期几1 - 7
%U一年中的一周（2 位数，0 填充）00 - 53
%VISO 8601 格式的一年中的一周1 - 53
%Y年份（4 位数，0 填充）0000 - 9999
%z与 UTC 的时区偏移量+/-[hh][mm]
%Z以分钟为单位，与 UTC 的时区偏移量+/-mmm
%%百分号作为字符%

3. 示例代码​

假设集合 students 有如下记录：

{ "date": "1999-12-11T16:00:00.000Z", "firstName": "Yuanxin", "lastName": "Dong" }
{ "date": "1998-11-10T16:00:00.000Z", "firstName": "Weijia", "lastName": "Wang" }
{ "date": "1997-10-09T16:00:00.000Z", "firstName": "Chengxi", "lastName": "Li" }

格式化日期​

下面是将 date 字段的值，格式化成形如 年份-月份-日期 的字符串：

// 云函数环境下示例代码
const tcb = require('@cloudbase/node-sdk')
const app = tcb.init({
  env: 'xxx'
})

const db = app.database()
const $ = db.command.aggregate

exports.main = async (event, context) => {
  const res = await db
    .collection('students')
    .aggregate()
    .project({
      _id: 0,
      formatDate: $.dateToString({
        date: '$date',
        format: '%Y-%m-%d'
      })
    })
    .end()
  console.log(res.data)
}

返回的结果如下：

{ "formatDate": "1999-12-11" }
{ "formatDate": "1998-11-10" }
{ "formatDate": "1997-10-09" }

时区时间​

下面是将 date 字段值格式化为上海时区时间的例子：

// 云函数环境下示例代码
const tcb = require('@cloudbase/node-sdk')
const app = tcb.init({
  env: 'xxx'
})

const db = app.database()
const $ = db.command.aggregate

exports.main = async (event, context) => {
  const res = await db
    .collection('students')
    .aggregate()
    .project({
      _id: 0,
      formatDate: $.dateToString({
        date: '$date',
        format: '%H:%M:%S',
        timezone: 'Asia/Shanghai'
      })
    })
    .end()
  console.log(res.data)
}

返回的结果如下：

{ "formatDate": "00:00:00" }
{ "formatDate": "00:00:00" }
{ "formatDate": "00:00:00" }

缺失情况的默认值​

当指定的 <日期表达式> 返回空或者不存在的时候，可以设置缺失情况下的默认值：

// 云函数环境下示例代码
const tcb = require('@cloudbase/node-sdk')
const app = tcb.init({
  env: 'xxx'
})

const db = app.database()
const $ = db.command.aggregate

exports.main = async (event, context) => {
  const res = await db
    .collection('students')
    .aggregate()
    .project({
      _id: 0,
      formatDate: $.dateToString({
        date: '$empty',
        onNull: 'null'
      })
    })
    .end()
  console.log(res.data)
}

返回的结果如下：

{ "formatDate": "null" }
{ "formatDate": "null" }
{ "formatDate": "null" }