use kwargs to hide require_iso8601

Author: minggli

pandas/core/dtypes/cast.py

@@ -916,7 +916,7 @@ def try_datetime(v):
             try:
                 from pandas import to_datetime
                 # GH19671
-                return to_datetime(v, _require_iso8601=True)
+                return to_datetime(v, require_iso8601=True)
             except Exception:
                 pass
 

pandas/core/tools/datetimes.py

@@ -106,16 +106,10 @@ def _convert_and_box_cache(arg, cache_array, box, errors, name=None):
 def to_datetime(arg, errors='raise', dayfirst=False, yearfirst=False,
                 utc=None, box=True, format=None, exact=True,
                 unit=None, infer_datetime_format=False, origin='unix',
-                cache=False, _require_iso8601=False):
+                cache=False, **kwargs):
     """
     Convert argument to datetime.
 
-    Passing _require_iso8601=True will only parse datetime strings similar to
-    `ISO8601 <https://en.wikipedia.org/wiki/ISO_8601>`_ and treat others as
-    non-parseable dates.
-
-    .. versionadded:: 0.23.0
-
     Parameters
     ----------
     arg : integer, float, string, datetime, list, tuple, 1-d array, Series
@@ -278,9 +272,10 @@ def to_datetime(arg, errors='raise', dayfirst=False, yearfirst=False,
     from pandas.core.indexes.datetimes import DatetimeIndex
 
     tz = 'utc' if utc else None
+    require_iso8601 = kwargs.get('require_iso8601', None)
 
     def _convert_listlike(arg, box, format, name=None, tz=tz,
-                          require_iso8601=_require_iso8601):
+                          require_iso8601=require_iso8601):
 
         if isinstance(arg, (list, tuple)):
             arg = np.array(arg, dtype='O')

pandas/tests/indexes/datetimes/test_tools.py

@@ -471,15 +471,15 @@ def test_datetime_require_iso8601(self):
         # GH19671
         s = Series(['M1809', 'M1701', Timestamp('20130101')])
         with pytest.raises(ValueError):
-            to_datetime(s, _require_iso8601=True, errors='raise')
+            to_datetime(s, require_iso8601=True, errors='raise')
         tm.assert_series_equal(
-            to_datetime(s, _require_iso8601=True, errors='ignore'),
+            to_datetime(s, require_iso8601=True, errors='ignore'),
             Series(['M1809', 'M1701', Timestamp('20130101')]))
         tm.assert_series_equal(
-            to_datetime(s, _require_iso8601=True, errors='coerce'),
+            to_datetime(s, require_iso8601=True, errors='coerce'),
             Series([NaT, NaT, Timestamp('20130101')]))
         tm.assert_series_equal(
-            to_datetime(s, _require_iso8601=False, errors='raise'),
+            to_datetime(s, require_iso8601=False, errors='raise'),
             Series([Timestamp('18090101'), Timestamp('17010101'),
                     Timestamp('20130101')]))