Skip to main content
`Ctrl`+`K`

# pandas.Timestamp.astimezone

Timestamp.astimezone(tz)

  Convert timezone-aware Timestamp to another time zone.

  This method is used to convert a timezone-aware Timestamp object to a different time zone. The original UTC time remains the same; only the time zone information is changed. If the Timestamp is timezone-naive, a TypeError is raised.

  Parameters:
    tz str, zoneinfo.ZoneInfo, pytz.timezone, dateutil.tz.tzfile or None

      Time zone for time which Timestamp will be converted to. None will remove timezone holding UTC time.

  Returns:
    converted Timestamp
  Raises:
    TypeError

      If Timestamp is tz-naive.

  See also

  `Timestamp.tz_localize`

    Localize the Timestamp to a timezone.

  `DatetimeIndex.tz_convert`

    Convert a DatetimeIndex to another time zone.

  `DatetimeIndex.tz_localize`

    Localize a DatetimeIndex to a specific time zone.

  `datetime.datetime.astimezone`

    Convert a datetime object to another time zone.

  Examples

  Create a timestamp object with UTC timezone:

      >>> ts = pd.Timestamp('2020-03-14T15:32:52.192548651', tz='UTC')
      >>> ts
      Timestamp('2020-03-14 15:32:52.192548651+0000', tz='UTC')

  Change to Tokyo timezone:

      >>> ts.tz_convert(tz='Asia/Tokyo')
      Timestamp('2020-03-15 00:32:52.192548651+0900', tz='Asia/Tokyo')

  Can also use `astimezone`:

      >>> ts.astimezone(tz='Asia/Tokyo')
      Timestamp('2020-03-15 00:32:52.192548651+0900', tz='Asia/Tokyo')

  Analogous for `pd.NaT`:

      >>> pd.NaT.tz_convert(tz='Asia/Tokyo')
      NaT