From d8caffa95d6fe0bfb24f311e681918280ca897f1 Mon Sep 17 00:00:00 2001 From: Patrick Hoefler Date: Sat, 25 Mar 2023 13:26:11 -0400 Subject: [PATCH 1/2] DOC: Update timestamp limitations --- doc/source/user_guide/timeseries.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/doc/source/user_guide/timeseries.rst b/doc/source/user_guide/timeseries.rst index 4cd98c89e7180..39b6ad95ab262 100644 --- a/doc/source/user_guide/timeseries.rst +++ b/doc/source/user_guide/timeseries.rst @@ -507,7 +507,8 @@ used if a custom frequency string is passed. Timestamp limitations --------------------- -Since pandas represents timestamps in nanosecond resolution, the time span that +The limits of timestamp representation depend on the chosen resolution. For +nanosecond resolution, the time span that can be represented using a 64-bit integer is limited to approximately 584 years: .. ipython:: python @@ -515,6 +516,8 @@ can be represented using a 64-bit integer is limited to approximately 584 years: pd.Timestamp.min pd.Timestamp.max +When choosing second-resolution, the available range grows to ``+/- 2.9e11 years``. + .. seealso:: :ref:`timeseries.oob` From 977f80479c4c1bb4e8dff68b8f58c031e782c7dc Mon Sep 17 00:00:00 2001 From: Patrick Hoefler Date: Mon, 27 Mar 2023 13:13:18 -0400 Subject: [PATCH 2/2] Add comment --- doc/source/user_guide/timeseries.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/source/user_guide/timeseries.rst b/doc/source/user_guide/timeseries.rst index 39b6ad95ab262..2c93efb128613 100644 --- a/doc/source/user_guide/timeseries.rst +++ b/doc/source/user_guide/timeseries.rst @@ -517,6 +517,7 @@ can be represented using a 64-bit integer is limited to approximately 584 years: pd.Timestamp.max When choosing second-resolution, the available range grows to ``+/- 2.9e11 years``. +Different resolutions can be converted to each other through ``as_unit``. .. seealso::