DOCSP-21234 add date example (#1035) (#1044)

* DOCSP-21234-add-date-example

* DOCSP-21234-add-date-example

* DOCSP-21234-add-date-example

* DOCSP-21234-add-date-example

* DOCSP-21234-add-date-example

* DOCSP-21234-add-date-example

Co-authored-by: jason-price-mongodb <[email protected]>

Co-authored-by: jason-price-mongodb <[email protected]>

Author: jason-price-mongodb

source/reference/method/Date.txt

@@ -105,3 +105,44 @@ The following example uses ``new Date()`` to return
 
    - :ref:`BSON Date <document-bson-type-date>`
    - :ref:`mongo Shell Date <mongo-shell-date-type>`
+
+Insert and Return ``ISODate`` Objects
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You can specify dates as ``ISODate`` objects.
+
+The following example creates a ``cakeSales`` collection with
+``ISODate`` objects in the ``orderDate`` field:
+
+.. code-block:: javascript
+
+   db.cakeSales.insertMany( [
+      { _id: 0, type: "chocolate", orderDate: new ISODate("2020-05-18T14:10:30Z") },
+      { _id: 1, type: "strawberry", orderDate: new ISODate("2021-03-20T11:30:05Z") },
+      { _id: 2, type: "vanilla", orderDate: new ISODate("2021-01-15T06:31:15Z") }
+   ] )
+
+The following example returns documents where the ``orderDate`` is less
+than the ``ISODate`` specified in the :expression:`$lt` operator:
+
+.. code-block:: javascript
+
+   db.cakeSales.find( { orderDate: { $lt: ISODate("2021-02-25T10:03:46.000Z") } } )
+
+Example output:
+
+.. code-block:: javascript
+   :copyable: false
+
+   [
+      {
+         _id: 0,
+         type: 'chocolate',
+         orderDate: ISODate("2020-05-18T14:10:30.000Z")
+      },
+      {
+         _id: 2,
+         type: 'vanilla',
+         orderDate: ISODate("2021-01-15T06:31:15.000Z")
+      }
+   ]