fix: Series.dt argument 'ambiguous' can be boolean

[cmp0xff]

Describe the bug

In the documentation and in practice, Series.dt.floor, Series.dt.round and Series.dt.ceil accept the argument ambiguous as boolean, which is however not supported in pandas-stubs.

To Reproduce

Provide a minimal runnable pandas example that is not properly checked by the stubs.

import pandas as pd

ts_series = pd.Series(pd.to_datetime(["2025-04-01 00:02+00"]))

ts_series.dt.floor(freq="min", ambiguous=False)

Indicate which type checker you are using (mypy or pyright).

mypy

Show the error message received from that type checker while checking your example.

dt_accessor.py:5:42: error: Argument "ambiguous" to "floor" of "_DatetimeRoundingMethods" has incompatible type "Literal[False]"; expected "Literal['raise', 'infer', 'NaT'] | ndarray[Any, dtype[bool_]]"  [arg-type]
Found 1 error in 1 file (checked 1 source file)

Please complete the following information:

OS: [e.g. Windows, Linux, MacOS]

Microsoft Windows 10 Enterprise

OS Version [e.g. 22]

10.0.19045 N/A Build 19045

python version

Python 3.13.2

version of type checker

mypy==1.15.0

version of installed pandas-stubs

pandas-stubs==2.2.3.250308

Additional context
Add any other context about the problem here.

[Dr-Irv]

Thanks for the PR. The CI is failing because pyright is picking up that the import of sqlalchemy.ext.declarative is unnecessary in test_io.py , probably due to an update to pyright . Can you just delete that import, commit and push?

[Dr-Irv]

Instead of doing the __all__ thing, can you just pin pyright to 1.1.397 in pyproject.toml, because I just reported an issue here in pyright : microsoft/pyright#10248

[Dr-Irv]

Also, can you not "force push" so then I can see what is changed with each commit more easily?

[cmp0xff]

Hi @Dr-Irv , thank you for the review and input. I force-pushed because I wanted to keep the commits clean.

[Dr-Irv]

Thanks @cmp0xff