Skip to main content
`Ctrl`+`K`

# pandas.DatetimeIndex.tz_convert

DatetimeIndex.tz_convert(tz)

  Convert tz-aware Datetime Array/Index from one time zone to another.

  This method converts each timestamp in the index to the target time zone while preserving the underlying UTC time. The index must already be timezone-aware.

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

      Time zone for time. Corresponding timestamps would be converted to this time zone of the Datetime Array/Index. A tz of None will convert to UTC and remove the timezone information.

  Returns:
    Array or Index

      Datetme Array/Index with target tz.

  Raises:
    TypeError

      If Datetime Array/Index is tz-naive.

  See also

  `DatetimeIndex.tz`

    A timezone that has a variable offset from UTC.

  `DatetimeIndex.tz_localize`

    Localize tz-naive DatetimeIndex to a given time zone, or remove timezone from a tz-aware DatetimeIndex.

  Examples

  With the tz parameter, we can change the DatetimeIndex to other time zones:

      >>> dti = pd.date_range(
      ...     start="2014-08-01 09:00", freq="h", periods=3, tz="Europe/Berlin"
      ... )

      >>> dti
      DatetimeIndex(['2014-08-01 09:00:00+02:00',
                     '2014-08-01 10:00:00+02:00',
                     '2014-08-01 11:00:00+02:00'],
                    dtype='datetime64[us, Europe/Berlin]', freq='h')

      >>> dti.tz_convert("US/Central")
      DatetimeIndex(['2014-08-01 02:00:00-05:00',
                     '2014-08-01 03:00:00-05:00',
                     '2014-08-01 04:00:00-05:00'],
                    dtype='datetime64[us, US/Central]', freq='h')

  With the `tz=None`, we can remove the timezone (after converting to UTC if necessary):

      >>> dti = pd.date_range(
      ...     start="2014-08-01 09:00", freq="h", periods=3, tz="Europe/Berlin"
      ... )

      >>> dti
      DatetimeIndex(['2014-08-01 09:00:00+02:00',
                     '2014-08-01 10:00:00+02:00',
                     '2014-08-01 11:00:00+02:00'],
                      dtype='datetime64[us, Europe/Berlin]', freq='h')

      >>> dti.tz_convert(None)
      DatetimeIndex(['2014-08-01 07:00:00',
                     '2014-08-01 08:00:00',
                     '2014-08-01 09:00:00'],
                      dtype='datetime64[us]', freq='h')