From 6691ef4a3641f7cc287b68dd8db6c1f918d4fbc0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Dea=20Mar=C3=ADa=20L=C3=A9on?= Date: Mon, 28 Aug 2023 19:50:45 +0200 Subject: [PATCH 1/4] Remove repetead NA --- doc/source/reference/arrays.rst | 3 --- doc/source/reference/missing_value.rst | 16 ++++++++++++++++ 2 files changed, 16 insertions(+), 3 deletions(-) create mode 100644 doc/source/reference/missing_value.rst diff --git a/doc/source/reference/arrays.rst b/doc/source/reference/arrays.rst index 41ddbd048e6c5..f8eca70c80825 100644 --- a/doc/source/reference/arrays.rst +++ b/doc/source/reference/arrays.rst @@ -465,7 +465,6 @@ pandas provides this through :class:`arrays.IntegerArray`. UInt16Dtype UInt32Dtype UInt64Dtype - NA .. _api.arrays.float_na: @@ -484,7 +483,6 @@ Nullable float Float32Dtype Float64Dtype - NA .. _api.arrays.categorical: @@ -621,7 +619,6 @@ with a bool :class:`numpy.ndarray`. :template: autosummary/class_without_autosummary.rst BooleanDtype - NA .. Dtype attributes which are manually listed in their docstrings: including diff --git a/doc/source/reference/missing_value.rst b/doc/source/reference/missing_value.rst new file mode 100644 index 0000000000000..c48aec7f05bfa --- /dev/null +++ b/doc/source/reference/missing_value.rst @@ -0,0 +1,16 @@ +{{ header }} + +.. _api.missing: + +============== +Missing values +============== +.. currentmodule:: pandas + +NA is the way to represent missing values for nullable dtypes (see below): + +.. autosummary:: + :toctree: api/ + :template: autosummary/class_without_autosummary.rst + + NA From e20af5b3568f5006ebeb70226f3a2d744f8ea3c1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Dea=20Mar=C3=ADa=20L=C3=A9on?= Date: Tue, 29 Aug 2023 11:15:01 +0200 Subject: [PATCH 2/4] Added file to toctree --- doc/source/reference/index.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/source/reference/index.rst b/doc/source/reference/index.rst index 6d3ce3d31f005..7da02f7958416 100644 --- a/doc/source/reference/index.rst +++ b/doc/source/reference/index.rst @@ -53,6 +53,7 @@ are mentioned in the documentation. options extensions testing + missing_value .. This is to prevent warnings in the doc build. We don't want to encourage .. these methods. From cd0276a85f0ad3ba8a4d31841c4e77cff8f4336f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Dea=20Mar=C3=ADa=20L=C3=A9on?= Date: Sat, 2 Sep 2023 16:42:14 +0200 Subject: [PATCH 3/4] changed _api.missing_value --- doc/source/reference/missing_value.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/source/reference/missing_value.rst b/doc/source/reference/missing_value.rst index c48aec7f05bfa..acd495268fc03 100644 --- a/doc/source/reference/missing_value.rst +++ b/doc/source/reference/missing_value.rst @@ -1,6 +1,6 @@ {{ header }} -.. _api.missing: +.. _api.missing_value: ============== Missing values From c9a697b71924573f9ae01c1a4c2a3d33671edda0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Dea=20Mar=C3=ADa=20L=C3=A9on?= Date: Thu, 28 Sep 2023 18:08:41 +0200 Subject: [PATCH 4/4] Added NaT to missing values section --- doc/source/reference/arrays.rst | 10 ---------- doc/source/reference/missing_value.rst | 8 ++++++++ 2 files changed, 8 insertions(+), 10 deletions(-) diff --git a/doc/source/reference/arrays.rst b/doc/source/reference/arrays.rst index f8eca70c80825..fe65364896f54 100644 --- a/doc/source/reference/arrays.rst +++ b/doc/source/reference/arrays.rst @@ -134,11 +134,6 @@ is the missing value for datetime data. Timestamp -.. autosummary:: - :toctree: api/ - - NaT - Properties ~~~~~~~~~~ .. autosummary:: @@ -257,11 +252,6 @@ is the missing value for timedelta data. Timedelta -.. autosummary:: - :toctree: api/ - - NaT - Properties ~~~~~~~~~~ .. autosummary:: diff --git a/doc/source/reference/missing_value.rst b/doc/source/reference/missing_value.rst index acd495268fc03..3bf22aef765d1 100644 --- a/doc/source/reference/missing_value.rst +++ b/doc/source/reference/missing_value.rst @@ -14,3 +14,11 @@ NA is the way to represent missing values for nullable dtypes (see below): :template: autosummary/class_without_autosummary.rst NA + +NaT is the missing value for timedelta and datetime data (see below): + +.. autosummary:: + :toctree: api/ + :template: autosummary/class_without_autosummary.rst + + NaT