pandas.Timestamp

класс pandas.Timestamp(ts_input= object>, year=None, month=None, day=None, hour=None, минута=None, second=None, microsecond=None, tzinfo=None, *, nanosecond=None, tz=None, unit=None, fold=None)

Замена pandas для объекта python datetime.datetime.

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

Параметры:

ts_inputdatetime-like, str, int, float

Значение для преобразования в Timestamp.

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

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

tzinfodatetime.tzinfo, опционально, по умолчанию None

наносекундаint, опционально, по умолчанию 0

tzstr, pytz.timezone, dateutil.tz.tzfile или None

Часовой пояс для времени, который будет иметь Timestamp.

единицаstr

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

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

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

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

Примечания

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

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