pandas.Timestamp

classpandas.Timestamp(ts_input=<объект object>, freq=None, tz=None, unit=None, year=None, month=None, day=None, hour=None, minute=None, second=None, microsecond=None, nanosecond=None, tzinfo=None, *, fold=None)

Замена объекта datetime.datetime из python в 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 или None

Временная зона для времени, которым будет обладать Timestamp.

unit:str

Единица, используемая для преобразования, если ts_input имеет тип int или float. Допустимые значения — ‘D’, ‘h’, ‘m’, ‘s’, ‘ms’, ‘us’ и ‘ns’. Например, ‘s’ означает секунды, а ‘ms’ — миллисекунды.

year, month, day:int

hour, minute, second, microsecond:int, необязательно, по умолчанию 0

nanosecond:int, необязательно, по умолчанию 0

tzinfo:datetime.tzinfo, необязательно, по умолчанию None

fold:{0, 1}, по умолчанию None, только ключевое слово

Из-за перехода на летнее/зимнее время одна временная отметка на часах может появляться дважды при переходе с летнего на зимнее время; fold описывает, соответствует ли datetime-like первому (0) или второму времени (1), когда часы достигают неоднозначного времени.

Введено в версии 1.1.0.

Примечания

Существуют по существу три соглашения об вызове конструктора. Основной вариант принимает четыре параметра. Они могут передаваться по позиции или по имени.

Два других варианта имитируют параметры из datetime.datetime. Они могут передаваться по позиции или по имени, но не в смешанном порядке.

Примеры

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

Это преобразует строку datetime-like

>>> 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 в наносекундах.
day_of_week	Возвращает день недели.
day_of_year	Возвращает день года.
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	Возвращает квартал года.
tz	Псевдоним для tzinfo.
week	Возвращает номер недели года.
weekofyear	Возвращает номер недели года.

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

Методы

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