BUG: Raise OutOfBoundsDatetime when replacing with out-of-bounds datetime64[ns] (GH#61671)

Author: iabhi4

doc/source/whatsnew/v3.0.0.rst

@@ -685,6 +685,7 @@ Datetimelike
 - Bug in :func:`tseries.frequencies.to_offset` would fail to parse frequency strings starting with "LWOM" (:issue:`59218`)
 - Bug in :meth:`DataFrame.fillna` raising an ``AssertionError`` instead of ``OutOfBoundsDatetime`` when filling a ``datetime64[ns]`` column with an out-of-bounds timestamp. Now correctly raises ``OutOfBoundsDatetime``. (:issue:`61208`)
 - Bug in :meth:`DataFrame.min` and :meth:`DataFrame.max` casting ``datetime64`` and ``timedelta64`` columns to ``float64`` and losing precision (:issue:`60850`)
+- Bug in :meth:`DataFrame.replace` where attempting to replace a ``datetime64[ns]`` column with an out-of-bounds timestamp would raise an ``AssertionError`` or silently coerce. Now correctly raises ``OutOfBoundsDatetime``. (:issue:`61671`)
 - Bug in :meth:`Dataframe.agg` with df with missing values resulting in IndexError (:issue:`58810`)
 - Bug in :meth:`DatetimeIndex.is_year_start` and :meth:`DatetimeIndex.is_quarter_start` does not raise on Custom business days frequencies bigger then "1C" (:issue:`58664`)
 - Bug in :meth:`DatetimeIndex.is_year_start` and :meth:`DatetimeIndex.is_quarter_start` returning ``False`` on double-digit frequencies (:issue:`58523`)

pandas/core/dtypes/cast.py

@@ -53,6 +53,7 @@
     ensure_str,
     is_bool,
     is_complex,
+    is_datetime64_dtype,
     is_float,
     is_integer,
     is_object_dtype,
@@ -1358,6 +1359,24 @@ def find_result_type(left_dtype: DtypeObj, right: Any) -> DtypeObj:
         dtype, _ = infer_dtype_from(right)
         new_dtype = find_common_type([left_dtype, dtype])
 
+        # GH#61671: datetime64[ns] inferred but the value may be out of bounds
+        if (
+            is_datetime64_dtype(new_dtype)
+            and lib.is_scalar(right)
+            and isinstance(right, (np.datetime64, dt.datetime))
+        ):
+            try:
+                ts = Timestamp(right)
+                casted = ts.as_unit("ns")
+                if Timestamp(casted) != ts:
+                    raise OutOfBoundsDatetime(
+                        f"{right!r} overflows datetime64[ns] during dtype inference"
+                    )
+            except (OverflowError, ValueError) as err:
+                raise OutOfBoundsDatetime(
+                    f"Cannot safely store {right!r} in inferred dtype 'datetime64[ns]'"
+                ) from err
+
     return new_dtype
 
 

pandas/tests/frame/methods/test_replace.py

@@ -6,6 +6,8 @@
 import numpy as np
 import pytest
 
+from pandas.errors import OutOfBoundsDatetime
+
 import pandas as pd
 from pandas import (
     DataFrame,
@@ -1430,6 +1432,23 @@ def test_replace_with_nil_na(self):
         result = ser.replace("nil", "anything else")
         tm.assert_frame_equal(expected, result)
 
+    @pytest.mark.parametrize("tz", [None, "US/Eastern"])
+    def test_replace_outofbounds_datetime_raises(self, tz):
+        # GH 61671
+        df = DataFrame([np.nan], dtype="datetime64[ns]")
+        too_big = Timestamp(datetime(3000, 1, 1), tz=tz)
+
+        if tz is None:
+            with pytest.raises(
+                OutOfBoundsDatetime,
+                match="Cannot safely store .* in inferred dtype 'datetime64\\[ns\\]'",
+            ):
+                df.replace(np.nan, too_big)
+        else:
+            # tz-aware datetimes are handled separately and don't trigger OOB as of now.
+            result = df.replace(np.nan, too_big)
+            assert result.iloc[0, 0] == too_big
+
 
 class TestDataFrameReplaceRegex:
     @pytest.mark.parametrize(