gh-124832: Add a note to indicate that datetime.now may return the same instant (#124834)

spacemanspiff2007 · vstinner · picnixz · web-flow · commit 760b1e103a0a · 2024-10-08T11:17:53.000-07:00
* Update datetime.rst

* Update datetime.rst

replace warning with note

* Update Doc/library/datetime.rst

Co-authored-by: Victor Stinner &lt;vstinner@python.org&gt;

* Update Doc/library/datetime.rst

Co-authored-by: Bénédikt Tran &lt;10796600+picnixz@users.noreply.github.com&gt;

---------

Co-authored-by: Victor Stinner &lt;vstinner@python.org&gt;
Co-authored-by: Bénédikt Tran &lt;10796600+picnixz@users.noreply.github.com&gt;
diff --git a/Doc/library/datetime.rst b/Doc/library/datetime.rst
@@ -948,6 +948,10 @@ Other constructors, all class methods:
 
    This function is preferred over :meth:`today` and :meth:`utcnow`.
 
+   .. note::
+
+      Subsequent calls to :meth:`!datetime.now` may return the same
+      instant depending on the precision of the underlying clock.
 
 .. classmethod:: datetime.utcnow()
 
