Bảng tra tần suất pandas 3 (frequency alias): D, W, ME, QE
Bài 14/17 · Chương 8
Dữ liệu thời gian
- 6 phút
- Cơ bản
- Python 3.14
- Cập nhật
Trong bài này · 11
Bí danh tần suất trong pandas (pandas frequency alias) là chuỗi ngắn như "D", "W", "ME" báo cho resample() và pd.date_range() biết một kỳ dài bao nhiêu: ngày, tuần, tháng. pandas 3 đổi tên vài bí danh quen thuộc, nên code cũ viết "M" hay "H" giờ dừng ngay với một thông báo lỗi.
Cần biết trước: date_range() và asfreq().
Bảng tra nhanh: bí danh tần suất pandas 3
Mỗi hàng dưới đây gom một mốc mẫu chung, 13:45 ngày 17/02/2026 (Thứ Ba), bằng resample() (hàm gom chuỗi thời gian theo kỳ) với bí danh của hàng đó; cột "Nhãn của mốc mẫu" là nhãn kỳ chứa mốc đó.
Bí danh | Kỳ | Nhãn kỳ | Tên cũ (pandas 2) | Nhãn của mốc mẫu |
|---|---|---|---|---|
| phút | đầu phút |
|
|
| giờ | đầu giờ |
|
|
| ngày | 0 giờ của ngày |
|
|
| tuần, hết Chủ nhật | Chủ nhật cuối tuần |
|
|
| tháng | ngày cuối tháng |
|
|
| tháng | ngày đầu tháng |
|
|
| quý | ngày cuối quý |
|
|
| quý | ngày đầu quý |
|
|
| năm | 31/12 |
|
|
| năm | 01/01 |
|
|
Khối dưới gom mốc mẫu bằng từng bí danh và in cột cuối, mỗi dòng vài hàng:
import pandas as pd
moc = pd.Series([1], index=[pd.Timestamp("2026-02-17 13:45")])
def nhan(bi_danh):
return str(moc.resample(bi_danh).sum().index[0])[:16]
print(nhan("min"), "|", nhan("h"), "|", nhan("D")[:10])
print(nhan("W")[:10], nhan("ME")[:10], nhan("MS")[:10])
print(nhan("QE")[:10], nhan("QS")[:10], nhan("YE")[:10],
nhan("YS")[:10])KẾT QUẢ
2026-02-17 13:45 | 2026-02-17 13:00 | 2026-02-17
2026-02-22 2026-02-28 2026-02-01
2026-03-31 2026-01-01 2026-12-31 2026-01-01Đổi "W" thành "W-MON" rồi chạy lại: dòng hai mở đầu bằng 2026-02-23, Thứ Hai cuối tuần. Cách dùng các bí danh này để tổng hợp doanh thu ngày, tuần, tháng có ở bài resample(); tạo dãy ngày đều nhau với chúng có ở bài mẹ của trang này.
Tên cũ M, Q, Y, H và lỗi trên pandas 3
Code chép từ sách, blog hay câu trả lời viết cho pandas 2 thường dùng "M", "Q", "Y" (hay "A") và "H", "T". pandas 3 đổi "M" thành "ME" (month end) để phân biệt với "MS" (month start), tương tự cho quý và năm; bí danh dưới một ngày chuyển sang chữ thường. Khi gặp lỗi, đọc phần gợi ý ở cuối thông báo:
Một trường hợp đáng nhớ: to_period() thì ngược lại, vẫn dùng "M", "Q", "Y", vì Period là cả kỳ chứ không có "đầu" hay "cuối"; bài to_period() nói kỹ hơn.
Nhãn đầu kỳ hay cuối kỳ: ME và MS
"ME" và "MS" chia tháng giống hệt nhau, cùng tổng, cùng trung bình; chỉ nhãn khác. Chọn "ME" khi báo cáo "tính tới hết tháng", chọn "MS" khi cần ghép với bảng chỉ tiêu đặt nhãn ngày 1:
import pandas as pd
ngay = pd.to_datetime(["2026-01-05", "2026-01-20", "2026-02-10"])
do = pd.Series([1, 2, 3], index=ngay)
cuoi = do.resample("ME").sum()
dau = do.resample("MS").sum()
print(cuoi.to_list(), cuoi.index.strftime("%d/%m").tolist())
print(dau.to_list(), dau.index.strftime("%d/%m").tolist())KẾT QUẢ
[3, 3] ['31/01', '28/02']
[3, 3] ['01/01', '01/02']Bội số và tuần bắt đầu Thứ Hai
Đặt một số trước bí danh để có kỳ dài gấp nhiều lần: "2h" là hai giờ, "15min" là mười lăm phút. "W-MON" là tuần kết thúc Thứ Hai; muốn tuần bắt đầu Thứ Hai và kết thúc Chủ nhật, như lịch làm việc ở Việt Nam, thì "W" (tức "W-SUN") đã đúng:
import pandas as pd
gio = pd.date_range("2026-01-01 06:00", periods=4, freq="2h")
print(gio.strftime("%H:%M").tolist())
phut = pd.date_range("2026-01-01 06:00", periods=3, freq="15min")
print(phut.strftime("%H:%M").tolist())KẾT QUẢ
['06:00', '08:00', '10:00', '12:00']
['06:00', '06:15', '06:30']Với resample("2h"), các khung hai giờ tính từ nửa đêm (0 giờ, 2 giờ, 4 giờ…), nên mốc 13:45 rơi vào khung có nhãn 12:00. Bội số dùng được với mọi bí danh trong bảng, như "2W" hay "6ME", nhưng báo cáo theo nửa năm thì "6ME" bắt đầu tính từ tháng có dữ liệu đầu tiên; kiểm nhãn trước khi in.
Kiểm tra nhanh
Sau
import pandas as pdvàdo = pd.Series([1], index=[pd.Timestamp("2026-05-14")]),str(do.resample("QE").sum().index[0].date())cho kết quả gì?'2026-06-30''2026-04-01''2026-05-31''2026-03-31'
Sau
import pandas as pd,pd.date_range("2026-01-15", periods=3, freq="MS").strftime("%d/%m").tolist()cho kết quả gì?['15/01', '15/02', '15/03']['01/02', '01/03', '01/04']['01/01', '01/02', '01/03']['31/01', '28/02', '31/03']
Code cũ viết resample("H").mean() và resample("Y").sum(). Trên pandas 3, phải đổi thành gì?
resample("h").mean()vàresample("YE").sum()resample("hour").mean()vàresample("year").sum()resample("H").mean()giữ nguyên, chỉ đổi"Y"thành"YE"resample("h").mean()vàresample("Y").sum()giữ nguyên
Bài tập
Gom số đo theo tên kỳ tiếng Việt
Màn hình báo cáo cho người dùng chọn kỳ bằng chữ: "giờ", "ngày", "tuần", "tháng", "quý" hay "năm". do là một Series số đếm, index là các mốc thời gian (có thể chưa sắp). Viết thân hàm gom_theo(do, ky):
Cộng
dotheo kỳ màkygọi tên, bằng bí danh pandas 3 bạn tự chọn cho từng tên.Nhãn: giờ, ngày theo đầu kỳ; tuần là Chủ nhật cuối tuần; tháng, quý, năm là ngày cuối kỳ. Kỳ trống giữa hai kỳ có dữ liệu vẫn có dòng với
0.
Hàm không sửa chuỗi do của nơi gọi.
Trả về: tổng của từng kỳ, một Series.
import pandas as pd
BI_DANH = {"giờ": "", "ngày": "", "tuần": "",
"tháng": "", "quý": "", "năm": ""} # Điền bí danh
def gom_theo(do, ky):
pass # Viết thân hàm thay cho dòng nàyTóm tắt
Bí danh tần suất cho
resample()vàpd.date_range():"min","h","D","W","ME","QE","YE".pandas 3 đổi
"M","Q","Y"thành"ME","QE","YE", và"H","T"thành"h","min"; tên cũ báoValueErrorkèm gợi ý.Nhóm
Eđặt nhãn cuối kỳ, nhómS("MS","QS","YS") đặt nhãn đầu kỳ;"W"là tuần hết Chủ nhật.Hai bảng gom bằng hai bí danh khác nhãn thì không ghép được theo nhãn.
Số đứng trước bí danh tạo bội số:
"2h","15min","2W".
Câu hỏi thường gặp
Pandas offset alias khác frequency alias không?
Cùng một thứ: tài liệu pandas gọi chuỗi như "ME" là "offset alias" vì phía sau mỗi chuỗi là một đối tượng offset, như pd.offsets.MonthEnd. Bạn có thể truyền thẳng đối tượng đó cho resample(), nhưng chuỗi ngắn gọn hơn và là cách viết phổ biến.
Resample ME pandas báo lỗi trên máy cũ là sao?
"ME" có từ pandas 2.2. Trên bản cũ hơn, tên đó chưa tồn tại và bạn phải dùng "M". Kiểm phiên bản bằng pd.__version__; trình chạy trên trang này dùng pandas 3.0, nên mọi bài trong khóa viết theo tên mới.
Tuần của Việt Nam bắt đầu Thứ Hai thì dùng bí danh nào?
"W", tức "W-SUN": mỗi tuần kết thúc Chủ nhật, nên bao từ Thứ Hai tới Chủ nhật. Nhãn là Chủ nhật cuối tuần; nếu báo cáo cần nhãn Thứ Hai đầu tuần, trừ 6 ngày khỏi nhãn bằng pd.Timedelta(days=6).
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.