mars.dataframe.Series.dt.tz_convert¶
- Series.dt.tz_convert(*args, **kwargs)¶
Convert tz-aware Datetime Array/Index from one time zone to another.
- 参数
tz (str, pytz.timezone, dateutil.tz.tzfile 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.
- 返回
- 返回类型
Array or Index
- 引发
TypeError – If Datetime Array/Index is tz-naive.
参见
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.
实际案例
With the tz parameter, we can change the DatetimeIndex to other time zones:
>>> import mars.dataframe as md >>> dti = md.date_range(start='2014-08-01 09:00', ... freq='H', periods=3, tz='Europe/Berlin')
>>> dti.execute() 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[ns, Europe/Berlin]', freq='H')
>>> dti.tz_convert('US/Central').execute() 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 the
tz=None
, we can remove the timezone (after converting to UTC if necessary):>>> dti = md.date_range(start='2014-08-01 09:00', freq='H', ... periods=3, tz='Europe/Berlin')
>>> dti.execute() 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[ns, Europe/Berlin]', freq='H')
>>> dti.tz_convert(None).execute() DatetimeIndex(['2014-08-01 07:00:00', '2014-08-01 08:00:00', '2014-08-01 09:00:00'], dtype='datetime64[ns]', freq='H')