Mongoose 时间戳（timestamps）.md

Mongoose 时间戳（timestamps）

Mongoose Schema 有一个 timestamps 选项，告诉 Mongoose 自动管理文档上的 createdAt 和 updatedAt 属性。例如，下面介绍如何在 User 模型上启用时间戳。

const userSchema = mongoose.Schema(
  {
    name: String
  },
  {
    timestamps: true
  }
)

const User = mongoose.model('User', userSchema)
const doc = await User.create({ name: 'O.O' })

doc.createdAt // 2021-08-20T22:36:59.414Z
doc.updatedAt // 2021-08-20T22:36:59.414Z

doc.createdAt instanceof Date // true

启用时间戳时，Mongoose 会将 createdAt 和 updatedAt 属性添加到模型中。默认情况下，createdAt 和 updatedAt 的类型为 Date。更新文档时，Mongoose 会自动增加 updatedAt。

doc.name = 'D.O'
await doc.save()

doc.createdAt // 2021-08-20T22:36:59.414Z
doc.updatedAt // 2021-08-20T22:37:09.071Z

特定的 mongoose 模型写入操作允许您跳过 timestamps，前提是在 Schema 中设置了时间戳。为此，必须将 timestamps 设置为 false，并且该操作不会更新时间。

const userSchema = mongoose.Schema(
  {
    name: String
  },
  {
    timestamps: true
  }
)

const User = mongoose.model('User', userSchema)

const doc = await User.findOneAndUpdate(
  {
    email: 'O.O'
  },
  {
    email: 'D.O'
  },
  {
    new: true,
    upsert: true,
    timestamps: false
  }
)

如果希望仅阻止其中一个更新，我们应该创建具有键值对的对象，而不是将 timestamps 设置为 false 作为值。根据需求，我们只需要根据需求将 createdAt 或 updatedAt 设置为 true 或 false。

const userSchema = mongoose.Schema(
  {
    name: String
  },
  {
    timestamps: true
  }
)

const User = mongoose.model('User', userSchema)

const doc = await User.findOneAndUpdate(
  {
    name: 'O.O'
  },
  {
    name: 'D.O'
  },
  {
    new: true,
    upsert: true,
    timestamps: {
      createdAt: false,
      updatedAt: true
    }
  }
)

备用属性名

默认情况下，Mongoose 使用 createdAt 和 updatedAt 作为时间戳的属性名。但你可以让 Mongoose 使用任何你喜欢的属性名。例如，如果您更喜欢 snake_case 属性名，可以让 Mongoose 使用 created_at 和 updated_at 替代：

const userSchema = mongoose.Schema(
  {
    name: String
  },
  {
    timestamps: {
      createdAt: 'created_at',
      updatedAt: 'updated_at'
    }
  }
)
const User = mongoose.model('User', userSchema)

const doc = await User.create({
  name: 'O.O'
})
doc.updated_at // 2021-08-20T22:40:06.667Z

使用 UNIX 时间戳

虽然日期类型通常已经足够了，但您也可以让 Mongoose 将时间戳存储为自 1970 年 1 月 1 日以来的秒数。Mongoose Schema 支持 timestamps.currentTime 选项，该选项允许您传递用于获取当前时间的自定义函数。

const userSchema = mongoose.Schema(
  {
    name: String
  },
  {
    // 让 Mongoose 使用 UNIX 时间（自1970年1月1日起的秒数）
    timestamps: {
      currentTime: () => Math.floor(Date.now() / 1000)
    }
  }
)