BUG fixing module first() and DateOffset

doc/source/whatsnew/v2.0.1.rst

@@ -33,6 +33,7 @@ Bug fixes
 - Bug in :meth:`ArrowDtype.__from_arrow__` not respecting if dtype is explicitly given (:issue:`52533`)
 - Bug in :meth:`DataFrame.max` and related casting different :class:`Timestamp` resolutions always to nanoseconds (:issue:`52524`)
 - Bug in :meth:`Series.describe` not returning :class:`ArrowDtype` with ``pyarrow.float64`` type with numeric data (:issue:`52427`)
+- Fixed bug in :func:`first` when used with a :class:`DateOffset` (:issue:`45908`)
 - Fixed bug in :func:`merge` when merging with ``ArrowDtype`` one one and a NumPy dtype on the other side (:issue:`52406`)
 - Fixed segfault in :meth:`Series.to_numpy` with ``null[pyarrow]`` dtype (:issue:`52443`)
 

pandas/core/generic.py

@@ -41,6 +41,7 @@
     Period,
     Tick,
     Timestamp,
+    offsets,
     to_offset,
 )
 from pandas._typing import (
@@ -9070,7 +9071,15 @@ def first(self, offset) -> Self:
         if len(self.index) == 0:
             return self.copy(deep=False)
 
+        if isinstance(offset, offsets.DateOffset):
+            end_date = end = self.index[0] + offset
+            if end_date in self.index:
+                end = self.index.searchsorted(end_date, side="left")
+                return self.iloc[:end]
+            return self.loc[:end]
+
         offset = to_offset(offset)
+
         if not isinstance(offset, Tick) and offset.is_on_offset(self.index[0]):
             # GH#29623 if first value is end of period, remove offset with n = 1
             #  before adding the real offset

pandas/tests/frame/methods/test_first_and_last.py

@@ -1,6 +1,7 @@
 """
 Note: includes tests for `last`
 """
+import numpy as np
 import pytest
 
 import pandas as pd
@@ -95,3 +96,50 @@ def test_empty_not_input(self, func):
         result = getattr(df, func)(offset=1)
         tm.assert_frame_equal(df, result)
         assert df is not result
+
+    @pytest.mark.parametrize("start, periods", [("2010-03-31", 1), ("2010-03-30", 2)])
+    def test_last_day_of_months_with_date_offset(self, frame_or_series, start, periods):
+        x = frame_or_series([1] * 100, index=pd.date_range(start, periods=100))
+        result = x.first(pd.DateOffset(days=periods))
+        expected = frame_or_series(
+            [1] * periods, index=pd.date_range(start, periods=periods)
+        )
+        tm.assert_equal(result, expected)
+
+    def test_date_offset_multiple_days(self, frame_or_series):
+        x = frame_or_series([1] * 100, index=pd.date_range("2010-03-31", periods=100))
+        result = x.first(pd.DateOffset(days=2))
+        expected = frame_or_series(
+            [1] * 2, index=pd.date_range("2010-03-31", "2010-04-01")
+        )
+        tm.assert_equal(result, expected)
+
+    def test_first_with_date_offset(self):
+        # GH#51284
+        i = pd.to_datetime(["2018-04-09", "2018-04-10", "2018-04-11", "2018-04-12"])
+        x = DataFrame({"A": [1, 2, 3, 4]}, index=i)
+        result = x.first(pd.DateOffset(days=2))
+        expected = DataFrame(
+            {"A": [1, 2]}, index=pd.to_datetime(["2018-04-09", "2018-04-10"])
+        )
+        tm.assert_equal(result, expected)
+
+    def test_date_offset_15_days(self):
+        # GH#45908
+        i = pd.date_range("2018-04-09", periods=30, freq="2D")
+        x = DataFrame({"A": np.arange(30)}, index=i)
+        result = x.first(pd.DateOffset(days=15))
+        i2 = pd.date_range("2018-04-09", periods=8, freq="2D")
+        expected = DataFrame({"A": np.arange(8)}, index=i2)
+        tm.assert_equal(result, expected)
+
+    def test_first_with_date_offset_months(self, frame_or_series):
+        periods = 40
+        x = frame_or_series(
+            [1] * periods, index=pd.date_range("2010-03-31", periods=periods)
+        )
+        result = x.first(pd.DateOffset(months=1))
+        expected = frame_or_series(
+            [1] * 30, index=pd.date_range("2010-03-31", periods=30)
+        )
+        tm.assert_equal(result, expected)