pandas.Index.shift

Index.shift(periods=1, freq=None)[source]

Сдвиг индекса на заданное число интервалов временной частоты.

Этот метод предназначен для сдвига значений индексов типа дата-время на заданный интервал времени указанное количество раз.

Параметры:

periods:int, по умолчанию 1

Число интервалов (или приращений) сдвига, может быть положительным или отрицательным.

freq:pandas.DateOffset, pandas.Timedelta или str, необязательно

Интервал частоты для сдвига. Если None, индекс сдвигается на свой собственный атрибут freq. Псевдонимы сдвигов допустимы в виде строк, например, ‘D’, ‘W’, ‘M’ и т.д.

Возвращаемое значение:

pandas.Index

Сдвинутый индекс.

См. также

Series.shift

Сдвиг значений Series.

Примечания

Этот метод реализован только для классов индексов типа дата-время, т.е. DatetimeIndex, PeriodIndex и TimedeltaIndex.

Примеры

Поместите первые 5 начальных дат месяцев 2011 года в индекс.

>>> month_starts = pd.date_range('1/1/2011', periods=5, freq='MS')
>>> month_starts
DatetimeIndex(['2011-01-01', '2011-02-01', '2011-03-01', '2011-04-01',
               '2011-05-01'],
              dtype='datetime64[ns]', freq='MS')

Сдвиньте индекс на 10 дней.

>>> month_starts.shift(10, freq='D')
DatetimeIndex(['2011-01-11', '2011-02-11', '2011-03-11', '2011-04-11',
               '2011-05-11'],
              dtype='datetime64[ns]', freq=None)

Значение по умолчанию freq — это значение атрибута freq индекса, которое в этом примере равно ‘MS’ (начало месяца).

>>> month_starts.shift(10)
DatetimeIndex(['2011-11-01', '2011-12-01', '2012-01-01', '2012-02-01',
               '2012-03-01'],
              dtype='datetime64[ns]', freq='MS')