DOCSP-25353 current date updates (#1931) (#1944)

* DOCSP-25353-current-date-updates

* DOCSP-25353-current-date-updates

* DOCSP-25353-current-date-updates

* DOCSP-25353-current-date-updates

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

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

Author: jason-price-mongodb

source/includes/update-current-date.rst

@@ -0,0 +1,2 @@
+:update:`$currentDate` sets the specified field to the date when
+:update:`$currentDate` was run.

source/reference/operator/update/currentDate.txt

@@ -43,6 +43,8 @@ Behavior
 
 .. include:: /includes/fact-update-operator-lexicographic-order.rst
 
+.. include:: /includes/update-current-date.rst
+
 If the field does not exist, :update:`$currentDate` adds the field to a
 document.
 
@@ -80,13 +82,15 @@ as well as updating the ``status`` field to ``"D"`` and the
       }
    )
 
-After the operation, you can query the collection to verify the update:
+.. include:: /includes/update-current-date.rst
+
+To verify the update:
 
 .. code-block:: javascript
 
    db.customers.find().pretty()
 
-The updated document would resemble:
+The updated document resembles:
 
 .. code-block:: javascript
    :copyable: false
@@ -101,6 +105,9 @@ The updated document would resemble:
       }
    }
 
+The ``lastModified`` field is set to the date when
+:update:`$currentDate` was run in the update example shown earlier.
+
 .. _currentDate-example-agg:
 
 Aggregation Alternative to ``$currentDate``