Skip to content

gh-91928: Add datetime.UTC alias for datetime.timezone.utc #91973

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Merged
merged 8 commits into from
May 3, 2022
Merged

gh-91928: Add datetime.UTC alias for datetime.timezone.utc #91973

merged 8 commits into from
May 3, 2022

Conversation

Kab1r
Copy link
Contributor

@Kab1r Kab1r commented Apr 27, 2022 •
edited by miss-islington
Loading

fixes #91928

UTC is now module attribute aliased to datetime.timezone.utc.
You can now do the following:

from datetime import UTC

Automerge-Triggered-By: GH:pganssle

@Kab1r Kab1r requested review from pganssle and abalkin as code owners April 27, 2022 00:59
@ghost
Copy link

ghost commented Apr 27, 2022 •
edited by ghost
Loading

All commit authors signed the Contributor License Agreement.
CLA signed

@bedevere-bot
Copy link

Every change to Python requires a NEWS entry.

Please, add it using the blurb_it Web app or the blurb command-line tool.

pganssle
pganssle requested changes Apr 27, 2022
View reviewed changes
Copy link
Member

@pganssle pganssle left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks great, thanks!

In addition to my other comments, two other things:

  1. As I believe you are a first-time contributor, you should probably add your name to Misc/ACKS.
  2. Maybe add a very simple test to TestModule, like this:
def test_utc_alias(self):
    self.assertIs(UTC, timezone.utc)

Thanks for your contribution!

@bedevere-bot
Copy link

A Python core developer has requested some changes be made to your pull request before we can consider merging it. If you could please address their requests along with any other requests in other reviews from core developers that would be appreciated.

Once you have made the requested changes, please leave a comment on this pull request containing the phrase I have made the requested changes; please review again. I will then notify any core developers who have left a review that you're ready for them to take another look at this pull request.

@pganssle pganssle mentioned this pull request Apr 27, 2022
Closed
@Kab1r
Copy link
Contributor Author

Kab1r commented Apr 27, 2022

I have made the requested changes; please review again

@bedevere-bot
Copy link

Thanks for making the requested changes!

@pganssle: please review the changes made to this pull request.

@bedevere-bot bedevere-bot requested a review from pganssle April 27, 2022 20:41
pganssle
pganssle requested changes Apr 27, 2022
View reviewed changes
Copy link
Member

@pganssle pganssle left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you add this test?

Maybe add a very simple test to TestModule, like this:

    def test_utc_alias(self):
       self.assertIs(UTC, timezone.utc)

@bedevere-bot
Copy link

A Python core developer has requested some changes be made to your pull request before we can consider merging it. If you could please address their requests along with any other requests in other reviews from core developers that would be appreciated.

Once you have made the requested changes, please leave a comment on this pull request containing the phrase I have made the requested changes; please review again. I will then notify any core developers who have left a review that you're ready for them to take another look at this pull request.

@Kab1r
Copy link
Contributor Author

Kab1r commented Apr 27, 2022

I had to move the definition of datetime.UTC to the end so that modifications to datetime.timezone.utc doesn't make it a different object.

@Kab1r
Copy link
Contributor Author

Kab1r commented Apr 27, 2022

I have made the requested changes; please review again

@bedevere-bot
Copy link

Thanks for making the requested changes!

@pganssle: please review the changes made to this pull request.

@bedevere-bot bedevere-bot requested a review from pganssle April 27, 2022 22:20
Kab1r and others added 4 commits May 3, 2022 14:02
@Kab1r @pganssle
docs(datetime): add versionadded to datetime.UTC
1e8257d
@Kab1r @pganssle
test(datetime): add test for datetime.UTC alias
7335f0a
@Kab1r @pganssle
fix(datetime): move datetime.UTC definition to end to ensure that i…
185c7ac 
…t is an alias
@pganssle
Clean up nits
9542f54 
1. Add UTC definition into C implementation as well (just for
   consistency, there's no particular reason not to simply assign the
   alias in the Python code later).

2. Move `..versionadded` tag into the right place
@pganssle pganssle force-pushed the feat-datetime-utc-alias branch from c097669 to 9542f54 Compare May 3, 2022 20:02
@miss-islington miss-islington merged commit 48c6165 into python:main May 3, 2022
@pganssle
Copy link
Member

pganssle commented May 3, 2022

Thanks @Kab1r!

@dignissimus dignissimus mentioned this pull request May 4, 2022
Merged
@jopemachine jopemachine mentioned this pull request Sep 9, 2022
Merged
natoscott added a commit to natoscott/pcp that referenced this pull request May 8, 2025
@natoscott
pmseries_import: use a datetime UTC interface from python3.6
e056732 
Resolves an issue Ken reported running tests in the QA farm,
which is due to use of an interface from more-recent-python:
python/cpython#91973
@natoscott natoscott mentioned this pull request May 8, 2025
Merged
@Shixiaowei02 Shixiaowei02 mentioned this pull request May 16, 2025
Merged
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers

@pganssle pganssle pganssle approved these changes

@abalkin abalkin Awaiting requested review from abalkin abalkin is a code owner

Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.

Add datetime.UTC alias for datetime.timezone.utc
4 participants
@Kab1r @bedevere-bot @pganssle @miss-islington