pandas.DatetimeIndex
-
class pandas.DatetimeIndex[source] -
Неизменяемый массив ndarray типа datetime64, представленный внутри как int64, и который может быть преобразован в объекты Timestamp, являющиеся подклассами datetime и несущие метаданные, такие как информация о частоте.
Параметры: -
data : array-like (1-dimensional), optional -
Необязательные данные типа datetime для построения индекса.
-
copy : bool -
Создать копию входного массива ndarray.
-
freq : string or pandas offset object, optional -
Один из строк-повторяемости pandas или соответствующих объектов. Строка 'infer' может быть передана для установки частоты индекса как выведенной частоты при создании.
-
start : starting value, datetime-like, optional -
Если data равно None, start используется как начальная точка при генерации регулярных временных меток.
Устарело начиная с версии 0.24.0.
-
periods : int, optional, > 0 -
Количество периодов для генерации, если генерируется индекс. Имеет приоритет над аргументом end.
Устарело начиная с версии 0.24.0.
-
end : end time, datetime-like, optional -
Если periods равно None, сгенерированный индекс будет расширяться до первой соответствующей метки времени на или сразу после аргумента end.
Устарело начиная с версии 0.24.0.
-
closed : string or None, default None -
Сделать интервал закрытым по отношению к заданной частоте к 'левой', 'правой' или обеим сторонам (None).
Устарело начиная с версии 0.24.0.
-
tz : pytz.timezone or dateutil.tz.tzfile -
ambiguous : ‘infer’, bool-ndarray, ‘NaT’, default ‘raise’ -
Когда часы двигаются назад из-за DST, могут возникнуть неоднозначные моменты времени. Например, в Центральноевропейском времени (UTC+01), при переходе от 03:00 DST к 02:00 не DST, 02:30:00 местного времени происходит как в 00:30:00 UTC, так и в 01:30:00 UTC. В такой ситуации параметр
ambiguousопределяет, как следует обрабатывать неоднозначные моменты времени.- ‘infer’ будет пытаться определить часы перехода DST к осени, основываясь на порядке.
- булевый массив ndarray, где True означает время DST, False означает время вне DST (обратите внимание, что этот флаг применим только к неоднозначным моментам времени).
- ‘NaT’ вернёт NaT, когда есть неоднозначные моменты времени.
- ‘raise’ вызовет AmbiguousTimeError, если есть неоднозначные моменты времени.
-
name : object -
Имя, которое будет сохранено в индексе.
-
dayfirst : bool, default False -
Если True, анализировать даты в
dataс порядком день сначала. -
yearfirst : bool, default False -
Если True, анализировать даты в
dataс порядком год сначала.
См. также
-
Index - Базовый тип индекса pandas.
-
TimedeltaIndex - Индекс данных типа timedelta64.
-
PeriodIndex - Индекс данных Period.
-
to_datetime - Преобразовать аргумент в datetime.
-
date_range - Создать DatetimeIndex с фиксированной частотой.
Примечания
Дополнительную информацию о строках частоты см. на этой ссылке.
Создание DatetimeIndex на основе
start,periods, иendустарело в пользуdate_range().Атрибуты
yearГод даты и времени. monthМесяц как Январь=1, Декабрь=12. dayДень даты и времени. hourЧасы даты и времени. minuteМинуты даты и времени. secondСекунды даты и времени. microsecondМикросекунды даты и времени. nanosecondНаносекунды даты и времени. dateВозвращает массив numpy объектов python datetime.date (именно часть даты Timestamp без информации о часовом поясе). timeВозвращает массив datetime.time. timetzВозвращает массив datetime.time, также содержащий информацию о часовом поясе. dayofyearПорядковый день года. weekofyearПорядковый номер недели года. weekПорядковый номер недели года. dayofweekДень недели, где понедельник=0, воскресенье=6. weekdayДень недели, где понедельник=0, воскресенье=6. quarterКвартал даты. freqВозвращает объект частоты, если он задан, иначе None. freqstrВозвращает строковое представление объекта частоты, если он задан, иначе None. is_month_startУказывает, является ли дата первым днём месяца. is_month_endУказывает, является ли дата последним днём месяца. is_quarter_startУказатель, является ли дата первым днём квартала. is_quarter_endУказатель, является ли дата последним днём квартала. is_year_startУказывает, является ли дата первым днём года. is_year_endУказывает, является ли дата последним днём года. is_leap_yearБулевый индикатор, принадлежит ли дата високосному году. inferred_freqПытается вернуть строку, представляющую предположение о частоте, сгенерированную с помощью infer_freq. tz Методы
-
normalize(self, \*args, \*\*kwargs)Преобразовать время в полночь. strftime(self, \*args, \*\*kwargs)Преобразовать в Индекс с указанным форматом даты. snap(self[, freq])Привязать метки времени к ближайшей частоте tz_convert(self, \*args, \*\*kwargs)Преобразовать массив/индекс Datetime с часовым поясом из одного часового пояса в другой. tz_localize(self, \*args, \*\*kwargs)Локализовать массив/индекс Datetime без часового пояса в массив/индекс Datetime с часовым поясом. round(self, \*args, \*\*kwargs)Выполнить операцию округления данных до указанного freq.floor(self, \*args, \*\*kwargs)Выполнить операцию округления вниз данных до указанного freq.ceil(self, \*args, \*\*kwargs)Выполнить операцию округления вверх данных до указанного freq.to_period(self, \*args, \*\*kwargs)Преобразовать в PeriodArray/Index с определённой частотой. to_perioddelta(self, \*args, \*\*kwargs)Вычислить TimedeltaArray разницы между значениями индекса и индексом, преобразованным в PeriodArray с указанной частотой. to_pydatetime(self, \*args, \*\*kwargs)Возвращает массив/индекс Datetime как объект ndarray объектов datetime.datetime. to_series(self[, keep_tz, index, name])Создать Series с индексом и значениями, равными ключам индекса, полезно при использовании map для возвращения индексатора на основе индекса. to_frame(self[, index, name])Создать DataFrame со столбцом, содержащим индекс. month_name(self, \*args, \*\*kwargs)Возвращает имена месяцев DateTimeIndex с указанным языковым стандартом. day_name(self, \*args, \*\*kwargs)Возвращает имена дней DateTimeIndex с указанным языковым стандартом. mean(self, \*args, \*\*kwargs)Возвращает среднее значение массива.
© 2008–2012, AQR Capital Management, LLC, Lambda Foundry, Inc. and PyData Development Team
Licensed under the 3-clause BSD License.
https://pandas.pydata.org/pandas-docs/version/0.25.0/reference/api/pandas.DatetimeIndex.html