time data does not match format: lỗi đọc ngày trong pandas
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
Trong bài này · 10
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 |
|---|---|---|
| cột lẫn hai kiểu ghi ngày |
|
| ngày không có thật, như 31/02 |
|
| năm gõ sai như 3026, đổi sang | sửa năm, hay giữ đơn vị |
không lỗi, năm 57440 | số | đổi sang chuỗi, |
Để 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 đó:
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:
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:
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:
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:
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
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
- Báo lỗi
Sau
import pandas as pdvàs = pd.Series(["05/03/2026", "x"]), lệnhprint(pd.to_datetime(s, format="%d/%m/%Y", errors="coerce").isna().sum())in ra gì?012
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
- Không cần làm gì, vì
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.
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àyTóm tắt
time data ... doesn't match formatnghĩa là một ô không viết theoformat=đã khai; đọc dòng đầu của thông báo để biết ô nào.errors="coerce"đổi mọi ô hỏng thànhNaT; lọcs[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ớidayfirst=True.pandas 3 đọc ngày bằng
[us]nên năm gõ sai như 3026 không báo lỗi; kiểmdt.yearsau 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ùngformat="%Y%m%d", không dùngunit="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ủ đề
Bài này có hữu ích?
Hỏi đáp
Tham vấn chuyên môn
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.