Skip to content

DOC: Update timestamp limitations #52204

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.

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

Merged
merged 2 commits into from
Mar 28, 2023
Merged

DOC: Update timestamp limitations #52204

merged 2 commits into from
Mar 28, 2023

Conversation

phofl
Copy link
Member

@phofl phofl commented Mar 25, 2023

  • closes #xxxx (Replace xxxx with the GitHub issue number)
  • Tests added and passed if fixing a bug or adding a new feature
  • All code checks passed.
  • Added type annotations to new arguments/methods/functions.
  • Added an entry in the latest doc/source/whatsnew/vX.X.X.rst file if fixing a bug or adding a new feature.

cc @jbrockmendel thoughts about updating this? Or should we rather start with explaining resolutions in general?

can be represented using a 64-bit integer is limited to approximately 584 years:

.. ipython:: python

pd.Timestamp.min
pd.Timestamp.max

When choosing second-resolution, the available range grows to ``+/- 2.9e11 years``.
Copy link
Member

Choose a reason for hiding this comment

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

should we add a sentence about converting between these with as_unit?

@mroeschke mroeschke added Docs Non-Nano datetime64/timedelta64 with non-nanosecond resolution Timestamp pd.Timestamp and associated methods labels Mar 27, 2023
@mroeschke mroeschke added this to the 2.0 milestone Mar 27, 2023
Copy link
Member

@MarcoGorelli MarcoGorelli left a comment

Choose a reason for hiding this comment

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

thanks @phofl

@MarcoGorelli MarcoGorelli merged commit ac993e7 into pandas-dev:main Mar 28, 2023
meeseeksmachine pushed a commit to meeseeksmachine/pandas that referenced this pull request Mar 28, 2023
MarcoGorelli pushed a commit that referenced this pull request Mar 28, 2023
#52255)

Backport PR #52204: DOC: Update timestamp limitations

Co-authored-by: Patrick Hoefler <[email protected]>
@phofl phofl deleted the docs_ts branch March 29, 2023 14:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Docs Non-Nano datetime64/timedelta64 with non-nanosecond resolution Timestamp pd.Timestamp and associated methods
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants