mars.dataframe.Series.dt.to_period#
- Series.dt.to_period(*args, **kwargs)#
Cast to PeriodArray/Index at a particular frequency.
Converts DatetimeArray/Index to PeriodArray/Index.
- 参数
freq (str or Offset, optional) – One of pandas’ offset strings or an Offset object. Will be inferred by default.
- 返回类型
PeriodArray/Index
- 引发
ValueError – When converting a DatetimeArray/Index with non-regular values, so that a frequency cannot be inferred.
参见
PeriodIndex
Immutable ndarray holding ordinal values.
DatetimeIndex.to_pydatetime
Return DatetimeIndex as object.
实际案例
>>> import mars.dataframe as md >>> df = md.DataFrame({"y": [1, 2, 3]}, ... index=md.to_datetime(["2000-03-31 00:00:00", ... "2000-05-31 00:00:00", ... "2000-08-31 00:00:00"])) >>> df.index.to_period("M").execute() PeriodIndex(['2000-03', '2000-05', '2000-08'], dtype='period[M]')
Infer the daily frequency
>>> idx = md.date_range("2017-01-01", periods=2) >>> idx.to_period().execute() PeriodIndex(['2017-01-01', '2017-01-02'], dtype='period[D]')