`pandas.to_datetime()`

Функция pd.to_datetime() преобразует строки, числа или последовательности в объекты типа datetime64[ns]. Поддерживает множество форматов: ISO-8601, Unix timestamp, произвольные форматы через format. Незаменима при анализе временных рядов с датчиков.

Сигнатура

pandas.to_datetime(arg, errors="raise", dayfirst=False,
                   yearfirst=False, format=None, unit=None,
                   utc=False)

Параметры

arg — значение, Series, список или DataFrame.
errors — поведение при ошибке: "raise", "coerce" (заменить на NaT), "ignore".
dayfirst — считать ли день первым (для формата 05/01/2024).
format — строка формата strftime, например "%Y-%m-%d %H:%M:%S".
unit — единица для числовых значений: "s", "ms", "us", "ns".
utc — приводить ли к UTC.

Возвращаемое значение

Timestamp, DatetimeIndex или Series с datetime64[ns].

Примеры

Пример 1. Парсинг ISO-строк

import pandas as pd

s = pd.Series(["2026-01-15 10:30:00", "2026-01-15 10:31:00"])
print(pd.to_datetime(s))

0   2026-01-15 10:30:00
1   2026-01-15 10:31:00
dtype: datetime64[ns]

Пример 2. Из Unix timestamp (millis() Arduino)

import pandas as pd

# секунды с эпохи
print(pd.to_datetime(1736942400, unit="s"))

2025-01-15 12:00:00

Пример 3. Явный формат

import pandas as pd

s = pd.Series(["15.01.2026", "16.01.2026"])
print(pd.to_datetime(s, format="%d.%m.%Y"))

0   2026-01-15
1   2026-01-16
dtype: datetime64[ns]

Пример 4. Обработка ошибок

import pandas as pd

s = pd.Series(["2026-01-15", "bad-data", "2026-01-17"])
print(pd.to_datetime(s, errors="coerce"))

 2026-01-15
        NaT
 2026-01-17
dtype: datetime64[ns]

Пример 5. Из DataFrame со столбцами year/month/day

import pandas as pd

df = pd.DataFrame({"year": [2026, 2026], "month": [1, 2], "day": [15, 20]})
print(pd.to_datetime(df))

0   2026-01-15
1   2026-02-20
dtype: datetime64[ns]

См. также

Примечание

Лицензия и источники

Техническое описание функции адаптировано из официальной документации Pandas (https://pandas.pydata.org/docs/), BSD-3-Clause License. Примеры и пояснения — © AlashEd Wiki.