pandas.Timestamp

class pandas.Timestamp

Замена объекта python datetime.datetime в pandas.

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')

Атрибуты

asm8	Возвращает формат numpy datetime64 в наносекундах.
dayofweek	Возвращает день недели.
dayofyear	Возвращает день года.
days_in_month	Возвращает количество дней в месяце.
daysinmonth	Возвращает количество дней в месяце.
freqstr	Возвращает общее количество дней в месяце.
is_leap_year	Возвращает True, если год високосный.
is_month_end	Возвращает True, если дата — последний день месяца.
is_month_start	Возвращает True, если дата — первый день месяца.
is_quarter_end	Возвращает True, если дата — последний день квартала.
is_quarter_start	Возвращает True, если дата — первый день квартала.
is_year_end	Возвращает True, если дата — последний день года.
is_year_start	Возвращает True, если дата — первый день года.
quarter	Возвращает квартал года.
resolution	Возвращает разрешение, описывающее наименьшее различие между двумя моментами времени, которые может представить объект Timestamp.
tz	Псевдоним для tzinfo
week	Возвращает номер недели в году.
weekday_name	(УСТЕРЕЖЕН) .. устарело:: 0.23.0
weekofyear	Возвращает номер недели в году.

day
fold
freq
hour
microsecond
minute
month
nanosecond
second
tzinfo
value
year

Методы

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

isoformat