reflow

Author: TomAugspurger

doc/source/whatsnew/v0.24.0.rst

@@ -1369,31 +1369,30 @@ The default behavior remains the same, but issues a warning:
 
    In [3]: pd.DatetimeIndex([946684800000000000], tz="US/Central")
    /bin/ipython:1: FutureWarning:
-       Passing integer-dtype data and a timezone to DatetimeIndex.
-       Integer values will be interpreted differently in a future version
-       of pandas. Previously, these were viewed as datetime64[ns] values
-       representing the wall time *in the specified timezone*.
-       In the future, these will be viewed as datetime64[ns] values
-       representing the wall time *in UTC*. This is similar to a
-       nanosecond-precision UNIX epoch.
-       To accept the future behavior, use
+       Passing integer-dtype data and a timezone to DatetimeIndex. Integer values
+       will be interpreted differently in a future version of pandas. Previously,
+       these were viewed as datetime64[ns] values representing the wall time
+       *in the specified timezone*. In the future, these will be viewed as
+       datetime64[ns] values representing the wall time *in UTC*. This is similar
+       to a nanosecond-precision UNIX epoch. To accept the future behavior, use
 
            pd.to_datetime(integer_data, utc=True).tz_convert(tz)
 
        To keep the previous behavior, use
 
-       pd.to_datetime(integer_data).tz_localize(tz)
+           pd.to_datetime(integer_data).tz_localize(tz)
 
-      #!/bin/python3
+    #!/bin/python3
     Out[3]: DatetimeIndex(['2000-01-01 00:00:00-06:00'], dtype='datetime64[ns, US/Central]', freq=None)
 
-As the warning message explains, opt in to the future behavior with
+As the warning message explains, opt in to the future behavior by specifying that
+the integer values are UTC, and then converting to the final timezone:
 
 .. ipython:: python
 
    pd.to_datetime([946684800000000000], utc=True).tz_convert('US/Central')
 
-And the old behavior can be retained with
+The old behavior can be retained with by localizing directly to the final timezone:
 
 .. ipython:: python
 

pandas/core/arrays/datetimes.py

@@ -34,14 +34,12 @@
 
 _midnight = time(0, 0)
 _i8_message = """
-    Passing integer-dtype data and a timezone to DatetimeIndex.
-    Integer values will be interpreted differently in a future version
-    of pandas. Previously, these were viewed as datetime64[ns] values
-    representing the wall time *in the specified timezone*.
-    In the future, these will be viewed as datetime64[ns] values
-    representing the wall time *in UTC*. This is similar to a
-    nanosecond-precision UNIX epoch.
-    To accept the future behavior, use
+    Passing integer-dtype data and a timezone to DatetimeIndex. Integer values
+    will be interpreted differently in a future version of pandas. Previously,
+    these were viewed as datetime64[ns] values representing the wall time
+    *in the specified timezone*. In the future, these will be viewed as
+    datetime64[ns] values representing the wall time *in UTC*. This is similar
+    to a nanosecond-precision UNIX epoch. To accept the future behavior, use
 
         pd.to_datetime(integer_data, utc=True).tz_convert(tz)