pandas.DatetimeIndex.tz_convert#

DatetimeIndex.tz_convert(tz)[source]#

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

Parameters:

tzstr, pytz.timezone, dateutil.tz.tzfile, datetime.tzinfo or None

Time zone for time. Corresponding timestamps would be convertedto this time zone of the Datetime Array/Index. Atz of None willconvert to UTC and remove the timezone information.

Returns:

Array or Index

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 thetz parameter, we can change the DatetimeIndexto other time zones:

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

>>>dtiDatetimeIndex(['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[ns, 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[ns, US/Central]', freq='h')

With thetz=None, we can remove the timezone (after convertingto UTC if necessary):

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

>>>dtiDatetimeIndex(['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[ns, 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[ns]', freq='h')