Pandas version checks

  • [x] I have checked that this issue has not already been reported.

  • [x] I have confirmed this bug exists on the latest version of pandas.

  • [x] I have confirmed this bug exists on the main branch of pandas.

Reproducible Example

import pandas as pd

# https://www.timeanddate.com/time/change/belgium/brussels?year=2022
ts = pd.Timestamp("2022-10-30", tz="Europe/Brussels")

offset_explicit_keyword = ts + pd.offsets.DateOffset(days=1)
offset_default_value = ts + pd.offsets.DateOffset(1)

assert offset_explicit_keyword == offset_default_value

Issue Description

According to the documentation, pd.offsets.DateOffset(1) should be the same as pd.offsets.DateOffset(days=1)

During instanciation the following function is called : https://github.com/pandas-dev/pandas/blob/bc6ad140daf230c470fef92bec598831d4f94a16/pandas/_libs/tslibs/offsets.pyx#L284-L334

For pd.offsets.DateOffset(1) it returns timedelta(days=1), False, whereas for pd.offsets.DateOffset(days=1) this returns relativedelta(days=1), True. This causes inconsistencies in the behavior of the two near DST transitions.

Expected Behavior

Either the doc can be changed or we ensure pd.offsets.DateOffset(1) equals pd.offsets.DateOffset(days=1) by my understanding this could be done in the following way

cdef _determine_offset(kwds):
     if not kwds:  
+        from dateutil.relativedelta import relativedelta 
+
         # GH 45643/45890: (historically) defaults to 1 day 
-        return timedelta(days=1), False 
+        return relativedelta(days=1), True

Installed Versions

INSTALLED VERSIONS ------------------ commit : c888af6d0bb674932007623c0867e1fbd4bdc2c6 python : 3.12.10 python-bits : 64 OS : Darwin OS-release : 24.5.0 Version : Darwin Kernel Version 24.5.0: Tue Apr 22 19:54:25 PDT 2025; root:xnu-11417.121.6~2/RELEASE_ARM64_T6020 machine : arm64 processor : arm byteorder : little LC_ALL : None LANG : None LOCALE : en_US.UTF-8 pandas : 2.3.1 numpy : 2.3.1 pytz : 2025.2 dateutil : 2.9.0.post0 pip : None Cython : None sphinx : None IPython : None adbc-driver-postgresql: None adbc-driver-sqlite : None bs4 : None blosc : None bottleneck : None dataframe-api-compat : None fastparquet : None fsspec : None html5lib : None hypothesis : None gcsfs : None jinja2 : None lxml.etree : None matplotlib : None numba : None numexpr : None odfpy : None openpyxl : None pandas_gbq : None psycopg2 : None pymysql : None pyarrow : None pyreadstat : None pytest : None python-calamine : None pyxlsb : None s3fs : None scipy : None sqlalchemy : None tables : None tabulate : None xarray : None xlrd : None xlsxwriter : None zstandard : None tzdata : 2025.2 qtpy : None pyqt5 : None