pandas.Timestamp

class pandas.Timestamp

Замена pandas для datetime.datetime

Timestamp — это аналог объекта Datetime из Python, и его можно использовать взаимозаменяемо в большинстве случаев. Это тип, используемый для элементов, составляющих DatetimeIndex, и других ориентированных на временные ряды структур данных в pandas.

Параметры:

ts_input : datetime-like, str, int, float Значение, которое нужно преобразовать в Timestamp freq : str, DateOffset Смещение, которое будет иметь Timestamp tz : str, pytz.timezone, dateutil.tz.tzfile or None Часовой пояс для времени, которое будет иметь Timestamp. unit : str Единица измерения, используемая для преобразования, если ts_input имеет тип int или float. Допустимые значения: ‘D’, ‘h’, ‘m’, ‘s’, ‘ms’, ‘us’ и ‘ns’. Например, ‘s’ означает секунды, а ‘ms’ — миллисекунды. year, month, day : int Новое в версии 0.19.0. hour, minute, second, microsecond : int, optional, default 0 Новое в версии 0.19.0. nanosecond : int, optional, default 0 Новое в версии 0.23.0. tzinfo : datetime.tzinfo, optional, default None Новое в версии 0.19.0.

Примечания

Существуют три основных способа вызова конструктора. Основной вариант принимает четыре параметра. Их можно передать по положению или по имени.

Два других варианта имитируют параметры из datetime.datetime. Их можно передать по положению или по имени, но не одновременно.

Примеры

Использование основного способа вызова:

Это преобразует строку, подобную дате и времени >>> pd.Timestamp(‘2017-01-01T12’) Timestamp(‘2017-01-01 12:00:00’)

Это преобразует число с плавающей точкой, представляющее эпоху Unix в единицах секунд >>> pd.Timestamp(1513393355.5, unit=’s’) Timestamp(‘2017-12-16 03:02:35.500000’)

Это преобразует целое число, представляющее эпоху Unix в единицах секунд и для определенного часового пояса >>> pd.Timestamp(1513393355, unit=’s’, tz=’US/Pacific’) Timestamp(‘2017-12-15 19:02:35-0800’, tz=’US/Pacific’)

Использование других двух вариантов, которые имитируют API datetime.datetime:

>>> pd.Timestamp(2017, 1, 1, 12)
Timestamp('2017-01-01 12:00:00')

>>> pd.Timestamp(year=2017, month=1, day=1, hour=12)
Timestamp('2017-01-01 12:00:00')

Атрибуты

resolution	Возвращает разрешение, описывающее наименьшее различие между двумя моментами времени, которые могут быть представлены объектом Timestamp.
tz	Псевдоним для tzinfo
weekday_name	(УСТЕРЕЖЕН) .. устаревший:: 0.23.0

asm8
day
dayofweek
dayofyear
days_in_month
daysinmonth
fold
freq
freqstr
hour
is_leap_year
is_month_end
is_month_start
is_quarter_end
is_quarter_start
is_year_end
is_year_start
microsecond
minute
month
nanosecond
quarter
second
tzinfo
value
week
weekofyear
year

Методы

astimezone	Преобразовать объект Timestamp с учетом часового пояса в другой часовой пояс.
ceil	возвращает новый объект Timestamp, округленный до заданного разрешения вверх
combine(дата, время)	дата, время -> дата и время с теми же полями
ctime	Возвращает строку в формате ctime().
date	Возвращает объект date с тем же годом, месяцем и днем.
day_name	Возвращает название дня недели объекта Timestamp с указанным языковым стандартом.
dst	Возвращает self.tzinfo.dst(self).
floor	возвращает новый объект Timestamp, округленный до заданного разрешения вниз
fromordinal(порядковый_номер[, частота, часовой_пояс])	передан порядковый номер, переводит и преобразует в объект ts, примечание: по определению в самом порядковом номере не может быть информации о часовом поясе
fromtimestamp(метка_времени)	метка_времени[, часовой_пояс] -> локальное время часового пояса из POSIX метки времени.
isocalendar	Возвращает кортеж из 3 элементов: год по ISO, номер недели и день недели.
isoweekday	Возвращает день недели, представленный датой.
month_name	Возвращает название месяца объекта Timestamp с указанным языковым стандартом.
normalize	Нормализовать объект Timestamp до полуночи, сохраняя информацию о часовом поясе.
now([часовой_пояс])	Возвращает новый объект Timestamp, представляющий текущее время, локальное для часового пояса.
replace	реализует datetime.replace, обрабатывает наносекунды
round	Округлить объект Timestamp до заданного разрешения
strftime	формат -> строка в формате strftime().
strptime	строка, формат -> новая дата и время, разобранная из строки (как time.strptime()).
time	Возвращает объект time с тем же временем, но с tzinfo=None.
timestamp	Возвращает POSIX метку времени в виде числа с плавающей точкой.
timetuple	Возвращает кортеж времени, совместимый с time.localtime().
timetz	Возвращает объект time с тем же временем и tzinfo.
to_datetime64	Возвращает объект numpy.datetime64 с точностью ‘ns’
to_julian_date	Преобразовать объект TimeStamp в дату по Юлианскому календарю.
to_period	Возвращает период, к которому относится этот объект timestamp.
to_pydatetime	Преобразовать объект Timestamp в обычный объект datetime Python.
today(cls[, часовой_пояс])	Возвращает текущее время в локальном часовом поясе.
toordinal	Возвращает пролептический григорианский порядковый номер.
tz_convert	Преобразовать объект Timestamp с учетом часового пояса в другой часовой пояс.
tz_localize	Преобразовать объект Timestamp без часового пояса в локальный часовой пояс или удалить часовой пояс из объекта Timestamp с учетом часового пояса.
tzname	Возвращает self.tzinfo.tzname(self).
utcfromtimestamp(метка_времени)	Создать объект datetime UTC без учета часового пояса из POSIX метки времени.
utcnow()	Возвращает новый объект Timestamp, представляющий текущее время в UTC.
utcoffset	Возвращает self.tzinfo.utcoffset(self).
utctimetuple	Возвращает кортеж времени UTC, совместимый с time.localtime().
weekday	Возвращает день недели, представленный датой.

isoformat