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

Bảng tra tần suất pandas 3 (frequency alias): D, W, ME, QE

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

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

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

"min"

phút

đầu phút

"T"

2026-02-17 13:45

"h"

giờ

đầu giờ

"H"

2026-02-17 13:00

"D"

ngày

0 giờ của ngày

"D"

2026-02-17

"W"

tuần, hết Chủ nhật

Chủ nhật cuối tuần

"W"

2026-02-22

"ME"

tháng

ngày cuối tháng

"M"

2026-02-28

"MS"

tháng

ngày đầu tháng

"MS"

2026-02-01

"QE"

quý

ngày cuối quý

"Q"

2026-03-31

"QS"

quý

ngày đầu quý

"QS"

2026-01-01

"YE"

năm

31/12

"Y", "A"

2026-12-31

"YS"

năm

01/01

"YS", "AS"

2026-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:

python
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:

python
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:

python
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

  1. Sau import pandas as pd và 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'
  2. 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']
  3. 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
Đúng hết lần đầu +15 XP

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 do theo kỳ mà ky gọ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.

python
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ày

Tó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áo ValueError kèm gợi ý.

  • Nhóm E đặt nhãn cuối kỳ, nhóm S ("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ủ đề

pandas frequency alias

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