Bỏ qua đến nội dung chính
Mục lục

time data does not match format: lỗi đọc ngày trong pandas

AIDev Team · duyệt: Nguyễn Việt Chung

Bài 11/13 · Chương 10

Giải nghĩa lỗi và cảnh báo

  • 6 phút
  • Trung cấp
  • Python 3.14
  • Cập nhật

Lỗi time data does not match format của pd.to_datetime() nghĩa là bạn đã khai một định dạng ngày bằng format=, và một ô trong cột không viết theo định dạng đó. Dòng đầu của thông báo kể ô đầu tiên bị lệch, như time data "2026-03-06" doesn't match format "%d/%m/%Y"; OutOfBoundsDatetime là lỗi cùng họ, báo ngày nằm ngoài khoảng mà kiểu thời gian chọn chứa được.

Cần biết trước: pd.to_datetime(), đọc ngày dd/mm/yyyy và pd.to_numeric().

Bảng tra nhanh: lỗi đọc ngày và cách sửa

Python gọi lỗi định dạng ngày là ValueError. Thông báo của pandas dài nhiều dòng: dòng đầu kể ô lỗi, các dòng sau là gợi ý chung, nên dòng cuối không cho biết ô nào sai. Hãy đọc dòng đầu.

Dòng đầu của thông báo

Nguyên nhân

Cách sửa

time data "2026-03-06" doesn't match format "%d/%m/%Y"

cột lẫn hai kiểu ghi ngày

errors="coerce" rồi đọc riêng phần còn lại

day is out of range for month

ngày không có thật, như 31/02

errors="coerce", rồi sửa tay ô đó

Out of bounds nanosecond timestamp

năm gõ sai như 3026, đổi sang [ns]

sửa năm, hay giữ đơn vị [us]

không lỗi, năm 57440

số 20260305 đọc bằng unit="D"

đổi sang chuỗi, format="%Y%m%d"

Để thấy dòng đầu mà không phải cuộn qua cả thông báo, bắt lỗi bằng try rồi in dòng đó:

python
import pandas as pd

ngay = pd.Series(["05/03/2026", "2026-03-06", "31/02/2026"])
try:
    pd.to_datetime(ngay, format="%d/%m/%Y")
except ValueError as loi:
    print(str(loi).splitlines()[0])

KẾT QUẢ

time data "2026-03-06" doesn't match format "%d/%m/%Y". You might want to try:

Ô thứ hai viết kiểu năm-tháng-ngày, khác định dạng ngày/tháng/năm bạn khai. pandas dừng ở ô đó nên chưa kịp báo ô thứ ba, ngày 31 tháng 2, cũng hỏng.

Tìm đủ các ô hỏng bằng errors="coerce"

Như với số, errors="coerce" đổi mọi ô không đọc được thành NaT (ô thời gian thiếu) thay vì dừng lại. Lọc các ô NaT là thấy hết chuỗi gây lỗi trong một lần:

python
import pandas as pd

ngay = pd.Series(["05/03/2026", "2026-03-06", "31/02/2026"])
doc = pd.to_datetime(ngay, format="%d/%m/%Y", errors="coerce")
print(doc.to_list())
print(ngay[doc.isna()].to_list())

KẾT QUẢ

[Timestamp('2026-03-05 00:00:00'), NaT, NaT]
['2026-03-06', '31/02/2026']

Ô 2026-03-06 là ngày thật viết kiểu khác, đọc lại được bằng format="%Y-%m-%d" rồi ghép vào. Ô 31/02/2026 không phải ngày có thật, cần hỏi lại người nhập. Đổi "31/02/2026" thành "28/02/2026" rồi chạy lại: dòng cuối in ['2026-03-06'].

OutOfBoundsDatetime: năm gõ sai

pandas 3 đọc ngày với đơn vị micro giây (datetime64[us]), chứa được năm 3026 mà không báo lỗi. Ngày gõ nhầm như 05/03/3026 vì thế lọt qua to_datetime() mà không ai biết; lỗi chỉ hiện ra khi một đoạn code khác đổi cột sang nano giây, đơn vị chỉ chứa được tới năm 2262:

python
import pandas as pd

ngay = pd.Series(["05/03/2026", "05/03/3026"])
doc = pd.to_datetime(ngay, format="%d/%m/%Y")
print(doc.dt.year.to_list())
doc.astype("datetime64[ns]")

Dòng cuối của thông báo lỗi:

text
pandas.errors.OutOfBoundsDatetime: Out of bounds nanosecond timestamp: 3026-03-05 00:00:00

Trên pandas 2, [ns] là đơn vị mặc định, nên chính to_datetime() báo lỗi: pandas 2.2 in OutOfBoundsDatetime: Out of bounds nanosecond timestamp: 3026-03-05, at position 0. Trên pandas 3, bạn tự kiểm năm sau khi đọc: doc.dt.year cho năm của từng ô, so với khoảng hợp lý của dữ liệu. doc.mask(dieu_kien) đổi các ô thỏa điều kiện thành NaT, để ô năm lạ không lọt vào báo cáo:

python
import pandas as pd

ngay = pd.Series(["05/03/2026", "05/03/3026"])
doc = pd.to_datetime(ngay, format="%d/%m/%Y")
la = doc.dt.year > 2030
print(doc.mask(la).to_list())

KẾT QUẢ

[Timestamp('2026-03-05 00:00:00'), NaT]

unit="D" chỉ đúng khi số thật sự là số ngày, như số sê-ri ngày của Excel: pd.to_datetime(46086, unit="D", origin="1899-12-30") cho ngày 5/3/2026.

Kiểm tra nhanh

  1. Sau import pandas as pd, pd.to_datetime(pd.Series(["2026-03-05"]), format="%d/%m/%Y") báo lỗi gì?

    • Báo lỗi ValueError
    • Báo lỗi KeyError
    • Báo lỗi TypeError
  2. Sau import pandas as pd và s = pd.Series(["05/03/2026", "x"]), lệnh print(pd.to_datetime(s, format="%d/%m/%Y", errors="coerce").isna().sum()) in ra gì?

    • 0
    • 1
    • 2
  3. Cột ngày đặt hàng đọc xong không lỗi, nhưng doc.dt.year.max() là 3026. Nên làm gì?

    • Không cần làm gì, vì to_datetime() không báo lỗi
    • Tìm các ô có năm lớn bất thường và hỏi lại người nhập
    • Đổi cột sang datetime64[ns] cho đúng chuẩn
Đúng hết lần đầu +15 XP

Bài tập

Đọc ngày và loại năm bất thường

Viết thân hàm doc_ngay_hop_le(ngay, nam_min, nam_max): ngay là Series chuỗi ngày dạng dd/mm/yyyy. Trả về Series thời gian đọc từ ngay, trong đó ô không đọc được theo định dạng đó, và ô có năm nhỏ hơn nam_min hay lớn hơn nam_max, thành NaT. Năm bằng nam_min hay nam_max vẫn giữ.

Series trả về giữ index và tên của ngay. Hàm không sửa Series ngay của nơi gọi.

Trả về: các ngày đã đọc, một Series.

python
import pandas as pd

def doc_ngay_hop_le(ngay, nam_min, nam_max):
    pass  # Viết thân hàm thay cho dòng này

Tóm tắt

  • time data ... doesn't match format nghĩa là một ô không viết theo format= đã khai; đọc dòng đầu của thông báo để biết ô nào.

  • errors="coerce" đổi mọi ô hỏng thành NaT; lọc s[doc.isna()] để thấy đủ các ô đó.

  • Cột lẫn hai kiểu ghi ngày: đọc riêng từng kiểu, đừng dựa vào format="mixed" với dayfirst=True.

  • pandas 3 đọc ngày bằng [us] nên năm gõ sai như 3026 không báo lỗi; kiểm dt.year sau khi đọc.

  • OutOfBoundsDatetime xuất hiện khi đổi sang [ns], đơn vị chỉ chứa tới năm 2262.

  • Ngày dạng số 20260305: đổi sang chuỗi và dùng format="%Y%m%d", không dùng unit="D".

Câu hỏi thường gặp

Vì sao dòng cuối của thông báo chỉ là gợi ý mà không có ô lỗi?

Thông báo lỗi ngày của pandas có nhiều dòng: dòng đầu là ô lỗi, các dòng sau kể ba cách gọi khác của to_datetime(). Python in dòng cuối sát cuối màn hình, nên hãy cuộn lên, hoặc bắt lỗi bằng try và in str(loi).splitlines()[0].

Không khai format= thì có hết lỗi không?

Không. pandas đoán định dạng từ ô đầu tiên rồi dùng cho cả cột, nên cột lẫn kiểu vẫn báo lỗi, và 05/03/2026 bị đọc thành ngày 3 tháng 5. Khai format="%d/%m/%Y"; cột thật sự lẫn nhiều kiểu thì dùng format="mixed", dayfirst=True rồi kiểm lại vài dòng. Bài pd.to_datetime() nói thêm về cách pandas đoán định dạng.

Lỗi unconverted data remains là gì?

Ô có thêm ký tự sau phần đã khớp format=, như giờ "05/03/2026 14:30" với format="%d/%m/%Y". Thêm phần giờ vào định dạng, "%d/%m/%Y %H:%M", hay cắt bỏ phần thừa trước khi đọc.

Chủ đề

time data does not match format

Bài này có hữu ích?

Hỏi đáp

Đang tải câu hỏi…

Tham vấn chuyên môn

Nguyễn Việt Chung

Nhà sáng lập AIDev và VietPlatform · Thạc sĩ AI MSE

  • Tốt nghiệp thủ khoa xuất sắc Thạc sĩ AI MSE.
  • Đồng sáng lập, CTO E-University, SVOnline: số hóa 10+ đại học, 40.000+ sinh viên.
  • Xây hệ thống AI cho doanh nghiệp tại VietPlatform.
Biên soạn: AIDev Team · Rà soát · Quy trình biên tập