Docs Home → Develop Applications → MongoDB Manual
Date()
Date()Returns a date either as a string or as a Date object.
Date()returns the current date as a string inmongosh.new Date()returns the current date as a Date object.mongoshwraps the Date object with theISODatehelper. TheISODateis in UTC.
You can specify a particular date by passing an ISO-8601 date string with a year within the inclusive range
0through9999to thenew Date()constructor or theISODate()function. These functions accept the following formats:new Date("<YYYY-mm-dd>")returns theISODatewith the specified date.new Date("<YYYY-mm-ddTHH:MM:ss>")specifies the datetime in the client's local timezone and returns theISODatewith the specified datetime in UTC.new Date("<YYYY-mm-ddTHH:MM:ssZ>")specifies the datetime in UTC and returns theISODatewith the specified datetime in UTC.new Date(<integer>)specifies the datetime as milliseconds since the UNIX epoch (Jan 1, 1970), and returns the resultingISODateinstance.
Behavior
Internally, Date objects are stored as a signed 64-bit integer representing the number of milliseconds since the Unix epoch (Jan 1, 1970).
Not all database operations and drivers support the full 64-bit range.
You may safely work with dates with years within the inclusive range
0 through 9999.
Examples
Use Date in a Query
If no document with _id equal to 1 exists in the products
collection, the following operation inserts a document with the field
dateAdded set to the current date:
db.products.updateOne( { _id: 1 }, { $set: { item: "apple" }, $setOnInsert: { dateAdded: new Date() } }, { upsert: true } )
Tip
See also:
NOW aggregation variable usage to update with aggregation pipeline
Return Date as a String
To return the date as a string, use the Date() method, as in the
following example:
var myDateString = Date();
Return Date as Date Object
mongosh wraps objects of
Date type with the ISODate helper;
however, the objects remain of type Date.
The following example uses new Date() to return
Date object with the specified UTC datetime.
var myDate = new Date("2016-05-18T16:00:00Z");