通过

$dateToString

该 $dateToString 运算符用于将日期对象转换为采用指定格式的字符串。 它通常用于聚合管道，以设置用于报告、查询或显示目的的日期字段的格式。 此运算符非常多才多艺，可用于定义自定义日期格式。

Syntax

{
  $dateToString: {
    format: "<format_string>",
    date: <date_expression>,
    timezone: "<timezone>",
    onNull: "<replacement_value>"
  }
}

参数

参数 Description
format 一个指定输出日期格式的字符串。
date 要设置格式的日期表达式。
timezone （可选）一个指定时区的字符串。 如果未提供，则默认为 UTC。
onNull （可选）如果字段为date或缺失，则null返回的值。

格式说明符

符号 Meaning
%Y 年份（四位数）
%m 月份（两位数）
%d 月份日期（两位数）
%H 小时（24 小时，两位数）
%M 分钟（两位数）
%S 第二个（两位数）
%L 毫秒（三位数）

例子

让我们了解 stores 数据集中的示例 json 的用法。

{
  "_id": "e6410bb3-843d-4fa6-8c70-7472925f6d0a",
  "name": "Relecloud | Toy Collection - North Jaylan",
  "location": {
    "lat": 2.0797,
    "lon": -94.4134
  },
  "staff": {
    "employeeCount": {
      "fullTime": 7,
      "partTime": 4
    }
  },
  "sales": {
    "salesByCategory": [
      {
        "categoryName": "Educational Toys",
        "totalSales": 3299
      }
    ],
    "revenue": 3299
  },
  "promotionEvents": [
    {
      "eventName": "Massive Markdown Mania",
      "promotionalDates": {
        "startDate": {
          "Year": 2024,
          "Month": 9,
          "Day": 21
        },
        "endDate": {
          "Year": 2024,
          "Month": 9,
          "Day": 29
        }
      },
      "discounts": [
        {
          "categoryName": "Remote Control Toys",
          "discountPercentage": 6
        },
        {
          "categoryName": "Building Sets",
          "discountPercentage": 21
        }
      ]
    }
  ],
  "company": "Relecloud",
  "city": "North Jaylan",
  "lastUpdated": {
    "$timestamp": {
      "t": 1733313006,
      "i": 1
    }
  },
  "storeOpeningDate": "2024-09-05T11:50:06.549Z"
}

示例 1：将日期字段的格式设置为类似 ISO 的字符串

查询使用 $dateToString 运算符将 lastUpdated 时间戳格式化为 YYYY-MM-DD 字符串。 它有助于以适合日志、报表或 UI 的可读格式显示日期。

db.stores.aggregate([
  {
    $match: { _id: "e6410bb3-843d-4fa6-8c70-7472925f6d0a" }
  },
  {
    $project: {
      _id: 0,
      formattedDate: {
        $dateToString: {
          format: "%Y-%m-%d",
          date: "$lastUpdated"
        }
      }
    }
  }
])

查询以格式化字符串lastUpdated的形式返回YYYY-MM-DD日期。

{
  "formattedDate": "2024-12-04"
}

示例 2：处理 Null 值

查询使用 /a0> 将不存在的字段时间戳格式化为字符串。 考虑到日期缺失或为 null，它将通过 onNull 选项替换回退字符串“无可用日期”。

db.stores.aggregate([
  {
    $match: { _id: "e6410bb3-843d-4fa6-8c70-7472925f6d0a" }
  },
  {
    $project: {
      _id: 0,
      formattedDateOrDefault: {
        $dateToString: {
          format: "%Y-%m-%d",
          date: "$lastUpdated_new", // field doesn't exist
          onNull: "No date available"
        }
      }
    }
  }
])

查询返回格式的默认消息，因为日期不存在。

{
  "formattedDateOrDefault": "No date available"
}

相关内容