DOC: timezone conversion example added to pandas.Series.astype doc #33399 (#33470)

* DOC: timezone conversion example added to pandas.Series.astype doc #33399

* DOC: fixed the whitespace issue flagged in pep8 checks #33399

* DOC: added text in comments to commentary in example #333999

* DOC: added a more generic behavior statement as suggested. #33399

* DOC: removed unwanted commentary statement as per suggestion #33399

Co-authored-by: Venkatesh Datta <[email protected]>

Author: venkateshdatta1993

pandas/core/generic.py

@@ -5545,6 +5545,24 @@ def astype(
         0    10
         1     2
         dtype: int64
+
+        Create a series of dates:
+
+        >>> ser_date = pd.Series(pd.date_range('20200101', periods=3))
+        >>> ser_date
+        0   2020-01-01
+        1   2020-01-02
+        2   2020-01-03
+        dtype: datetime64[ns]
+
+        Datetimes are localized to UTC first before
+        converting to the specified timezone:
+
+        >>> ser_date.astype('datetime64[ns, US/Eastern]')
+        0   2019-12-31 19:00:00-05:00
+        1   2020-01-01 19:00:00-05:00
+        2   2020-01-02 19:00:00-05:00
+        dtype: datetime64[ns, US/Eastern]
         """
         if is_dict_like(dtype):
             if self.ndim == 1:  # i.e. Series