From 8cb196378c16f5483f9892b50a8c4755cd7ad9b1 Mon Sep 17 00:00:00 2001 From: Natalia Mokeeva Date: Mon, 10 Jun 2024 23:39:44 +0200 Subject: [PATCH 1/5] add examples to is_year_start --- pandas/core/arrays/datetimes.py | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/pandas/core/arrays/datetimes.py b/pandas/core/arrays/datetimes.py index 077bde35a4c94..0027be180e175 100644 --- a/pandas/core/arrays/datetimes.py +++ b/pandas/core/arrays/datetimes.py @@ -2119,6 +2119,32 @@ def isocalendar(self) -> DataFrame: >>> idx.is_year_start array([False, False, True]) + + This method, when applied to Series with datetime values under + the ``.dt`` accessor, will lose information about Business offsets. + + >>> dates = pd.Series(pd.date_range("2020-10-30", periods=4, freq="BYS")) + >>> dates + 0 2021-01-01 + 1 2022-01-03 + 2 2023-01-02 + 3 2024-01-01 + dtype: datetime64[ns] + + >>> dates.dt.is_year_start + 0 True + 1 False + 2 False + 3 True + dtype: bool + + >>> idx = pd.date_range("2020-10-30", periods=4, freq="BYS") + >>> idx + DatetimeIndex(['2021-01-01', '2022-01-03', '2023-01-02', '2024-01-01'], + dtype='datetime64[ns]', freq='BYS-JAN') + + >>> idx.is_year_start + array([True, True, True, True] """, ) is_year_end = _field_accessor( From fab9be312c3b7b9e25492839c3956335dbfe83d0 Mon Sep 17 00:00:00 2001 From: Natalia Mokeeva Date: Tue, 11 Jun 2024 14:09:50 +0200 Subject: [PATCH 2/5] add missing spaces --- pandas/core/arrays/datetimes.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pandas/core/arrays/datetimes.py b/pandas/core/arrays/datetimes.py index 0027be180e175..b2d64cd0d97ee 100644 --- a/pandas/core/arrays/datetimes.py +++ b/pandas/core/arrays/datetimes.py @@ -2144,7 +2144,7 @@ def isocalendar(self) -> DataFrame: dtype='datetime64[ns]', freq='BYS-JAN') >>> idx.is_year_start - array([True, True, True, True] + array([ True, True, True, True] """, ) is_year_end = _field_accessor( From 8efe16a52816d3aa251e1eedbb3dba58b6e64e20 Mon Sep 17 00:00:00 2001 From: Natalia Mokeeva Date: Tue, 11 Jun 2024 14:57:04 +0200 Subject: [PATCH 3/5] remove unnecessary spaces --- pandas/core/arrays/datetimes.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pandas/core/arrays/datetimes.py b/pandas/core/arrays/datetimes.py index b2d64cd0d97ee..16795fdd6317d 100644 --- a/pandas/core/arrays/datetimes.py +++ b/pandas/core/arrays/datetimes.py @@ -2144,7 +2144,7 @@ def isocalendar(self) -> DataFrame: dtype='datetime64[ns]', freq='BYS-JAN') >>> idx.is_year_start - array([ True, True, True, True] + array([True, True, True, True] """, ) is_year_end = _field_accessor( From cf0b97cc8a674ca12f854f9499cbdcaf9d60273e Mon Sep 17 00:00:00 2001 From: Natalia Mokeeva Date: Tue, 11 Jun 2024 15:52:03 +0200 Subject: [PATCH 4/5] add missing parentheses --- pandas/core/arrays/datetimes.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pandas/core/arrays/datetimes.py b/pandas/core/arrays/datetimes.py index 16795fdd6317d..3d0ef08b26410 100644 --- a/pandas/core/arrays/datetimes.py +++ b/pandas/core/arrays/datetimes.py @@ -2144,7 +2144,7 @@ def isocalendar(self) -> DataFrame: dtype='datetime64[ns]', freq='BYS-JAN') >>> idx.is_year_start - array([True, True, True, True] + array([True, True, True, True]) """, ) is_year_end = _field_accessor( From 67ca8c92fcd1715bbb26948afe95dc52dd8e5333 Mon Sep 17 00:00:00 2001 From: Natalia Mokeeva Date: Wed, 12 Jun 2024 14:12:37 +0200 Subject: [PATCH 5/5] update is_year_start example --- pandas/core/arrays/datetimes.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pandas/core/arrays/datetimes.py b/pandas/core/arrays/datetimes.py index 3d0ef08b26410..e0a4587535cfd 100644 --- a/pandas/core/arrays/datetimes.py +++ b/pandas/core/arrays/datetimes.py @@ -2144,7 +2144,7 @@ def isocalendar(self) -> DataFrame: dtype='datetime64[ns]', freq='BYS-JAN') >>> idx.is_year_start - array([True, True, True, True]) + array([ True, True, True, True]) """, ) is_year_end = _field_accessor(