gh-103857: Document utcnow and utcfromtimestamp deprecations in What's New (#104542)

hugovk · pganssle · web-flow · commit 5841fbc1a2aa · 2023-05-21T13:45:44.000-06:00
Co-authored-by: Paul Ganssle &lt;1377457+pganssle@users.noreply.github.com&gt;
diff --git a/Doc/whatsnew/3.12.rst b/Doc/whatsnew/3.12.rst
@@ -774,6 +774,16 @@ Deprecated
   ``int``, convert to int explicitly with ``~int(x)``. (Contributed by Tim Hoffmann
   in :gh:`103487`.)
 
+* :class:`datetime.datetime`'s
+  :meth:`~datetime.datetime.utcnow` and
+  :meth:`~datetime.datetime.utcfromtimestamp` are deprecated and will be
+  removed in a future version. Instead, use timezone-aware objects to represent
+  datetimes in UTC: respectively, call
+  :meth:`~datetime.datetime.now` and
+  :meth:`~datetime.datetime.fromtimestamp`  with the *tz* parameter set to
+  :attr:`datetime.UTC`.
+  (Contributed by Paul Ganssle in :gh:`103857`.)
+
 Pending Removal in Python 3.13
 ------------------------------
 
diff --git a/Modules/_datetimemodule.c b/Modules/_datetimemodule.c
@@ -5190,7 +5190,7 @@ datetime_utcfromtimestamp(PyObject *cls, PyObject *args)
     if (PyErr_WarnEx(PyExc_DeprecationWarning,
         "datetime.utcfromtimestamp() is deprecated and scheduled for removal "
         "in a future version. Use timezone-aware objects to represent "
-        "datetimes in UTC: datetime.now(datetime.UTC).", 1))
+        "datetimes in UTC: datetime.fromtimestamp(timestamp, datetime.UTC).", 1))
     {
         return NULL;
     }

Original file line number	Diff line number	Diff line change
`@@ -5190,7 +5190,7 @@ datetime_utcfromtimestamp(PyObject cls, PyObject args)`
`5190`	`5190`	`if (PyErr_WarnEx(PyExc_DeprecationWarning,`
`5191`	`5191`	`"datetime.utcfromtimestamp() is deprecated and scheduled for removal "`
`5192`	`5192`	`"in a future version. Use timezone-aware objects to represent "`
`5193`		`- "datetimes in UTC: datetime.now(datetime.UTC).", 1))`
	`5193`	`+ "datetimes in UTC: datetime.fromtimestamp(timestamp, datetime.UTC).", 1))`
`5194`	`5194`	`{`
`5195`	`5195`	`return NULL;`
`5196`	`5196`	`}`