pandas.Timestamp

classpandas.Timestamp(ts_input=<object object>, year=None, month=None, day=None, hour=None, minute=None, second=None, microsecond=None, tzinfo=None, *, nanosecond=None, tz=None, unit=None, fold=None)

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

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

Параметры:

ts_input:datetime-like, str, int, float

Значение, которое нужно преобразовать в Timestamp.

год, месяц, день:int

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

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

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

tz:str, pytz.timezone, dateutil.tz.tzfile или None

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

unit:str

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

Для входных данных типа float результат будет храниться в наносекундах, а атрибут unit будет установлен как 'ns'.

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

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

Примечания

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

Два других варианта имитируют параметры из 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
day_of_week	Возвращает день недели.
day_of_year	Возвращает день года.
dayofweek	Возвращает день недели.
dayofyear	Возвращает день года.
days_in_month	Возвращает количество дней в месяце.
daysinmonth	Возвращает количество дней в месяце.
fold
hour
is_leap_year	Возвращает True, если год високосный.
is_month_end	Проверяет, является ли дата последним днем месяца.
is_month_start	Проверяет, является ли дата первым днем месяца.
is_quarter_end	Проверяет, является ли дата последним днем квартала.
is_quarter_start	Проверяет, является ли дата первым днем квартала.
is_year_end	Возвращает True, если дата — последний день года.
is_year_start	Возвращает True, если дата — первый день года.
max
microsecond
min
minute
month
nanosecond
quarter	Возвращает квартал года.
resolution
second
tz	Псевдоним для tzinfo.
tzinfo
unit	Сокращение, связанное с self._creso.
value
week	Возвращает номер недели года.
weekofyear	Возвращает номер недели года.
year

Методы

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