`utcnow` deprecation note is misleading

Documentation

Currently, the deprecation notice for datetime.utcnow() reads:

Deprecated since version 3.12: Use datetime.now() with UTC instead.

Unfortunately, applying this suggestion verbatim can easily break user code – especially when applying it to libraries. (See for example https://foss.heptapod.net/openpyxl/openpyxl/-/issues/2051). These datetime-related TypeErrors are easy to introduce, and fairly hard to fix. I suggest to amend the deprecation notice:

Deprecated since version 3.12: Use datetime.now(UTC) instead. Please note that this will return an aware datetime object. If you need to remain compatible, use datetime.now(UTC).replace(tzinfo=None).

Maybe someone can come up with a better wording.

Linked PRs

• gh-118571

Xem lại tài liệu về datetime.datetime.utcnow() trên trang datetime được liên kết và so sánh cách diễn đạt được đề xuất với PR gh-118571. Được xem là hoàn tất khi ghi chú deprecation cảnh báo rõ ràng rằng datetime.now(UTC) trả về một aware datetime và nêu tùy chọn tương thích replace(tzinfo=None), hoặc áp dụng cách diễn đạt tốt hơn đã được thống nhất.