MongoDBで日付付きドキュメントを挿入する方法をわかりやすく解説

MongoDBで日付付きドキュメントを挿入する方法

MongoDBに日付（Date型）を含むドキュメントを挿入するには、Date()コンストラクタを使用します。Date()に「YYYY-MM-DD」形式の日付文字列を渡すことで、指定した日時を持つフィールドを作成できます。

基本構文

"yourFieldName": new Date("yourDateValue")

なお、MongoDB内部では日付はUTC（協定世界時）基準のISODateとして保存されます。時刻を省略した場合は00:00:00（UTC）として扱われる点に注意しましょう。

insertOne()でドキュメントを挿入する

それでは、実際に日付付きドキュメントを含むコレクションを作成してみましょう。次のクエリでは、ユーザー名・メッセージ・投稿日時を持つドキュメントを3件挿入しています。

> db.insertDocumentWithDateDemo.insertOne({"UserName":"Larry","UserMessage":"Hi","UserMessagePostDate":new Date("2012-09-24")});
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5c9cca58a629b87623db1b16")
}
> db.insertDocumentWithDateDemo.insertOne({"UserName":"Chris","UserMessage":"Hello","UserMessagePostDate":new Date("2015-12-31")});
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5c9cca71a629b87623db1b17")
}
> db.insertDocumentWithDateDemo.insertOne({"UserName":"Robert","UserMessage":"Bye","UserMessagePostDate":new Date("2019-01-01")});
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5c9cca85a629b87623db1b18")
}

find()メソッドで挿入結果を確認する

コレクション内のすべてのドキュメントを表示するには、find()メソッドを使用します。pretty()を組み合わせると、インデントされた読みやすい形式で出力されます。

> db.insertDocumentWithDateDemo.find().pretty()

実行結果

{
    "_id" : ObjectId("5c9cca58a629b87623db1b16"),
    "UserName" : "Larry",
    "UserMessage" : "Hi",
    "UserMessagePostDate" : ISODate("2012-09-24T00:00:00Z")
}
{
    "_id" : ObjectId("5c9cca71a629b87623db1b17"),
    "UserName" : "Chris",
    "UserMessage" : "Hello",
    "UserMessagePostDate" : ISODate("2015-12-31T00:00:00Z")
}
{
    "_id" : ObjectId("5c9cca85a629b87623db1b18"),
    "UserName" : "Robert",
    "UserMessage" : "Bye",
    "UserMessagePostDate" : ISODate("2019-01-01T00:00:00Z")
}

ポイントまとめ

• 日付フィールドは new Date("YYYY-MM-DD") の形式で指定する
• 保存される日付はUTC基準のISODate型になり、時刻を省略すると00:00:00Zとなる
• 現在日時を挿入したい場合は、引数なしの new Date() を使用する
• 挿入結果の確認には find().pretty() が便利