...
Eroare Python pentru analiza datelor · Date calendaristice

ValueError: Invalid frequency: M. Failed to parse with error message: ValueError("'M' is no longer supported for offsets. Please use 'ME' instead.")

Pe scurt

În pandas 3, frecvența 'M' (sfârșit de lună) nu mai e acceptată la resample, date_range sau Grouper: scrie 'ME' (month end). La fel, 'Y' devine 'YE', 'Q' devine 'QE', iar 'H' devine 'h'. La to_period, 'M' rămâne valid.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Frecvențele de timp sunt coduri scurte: D zi, W săptămână, ME sfârșit de lună, MS început de lună, QE sfârșit de trimestru, YE sfârșit de an. În pandas 2.2, codurile vechi M, Q, Y (și A) au fost redenumite în ME, QE, YE, ca să fie clar că se referă la sfârșitul perioadei, iar folosirea lor dădea un FutureWarning. În pandas 3 nu mai sunt acceptate, deci resample("M") se oprește cu mesajul de mai sus.

Excepția importantă e to_period("M") și pd.Period: acolo M înseamnă „perioada lună” și rămâne valid. De aceea poți vedea în același program dt.to_period("M") funcționând și resample("M") dând eroare.

Similar, orele și minutele s-au mutat la litere mici: h pentru oră, min pentru minut, s pentru secundă.

De ce apare: cauzele frecvente

1Totaluri lunare cu resample

Greșit
PYTHON
lunar = vanzari.resample("M", on="data")["suma"].sum()
Corect
PYTHON
lunar = vanzari.resample("ME", on="data")["suma"].sum()

ME grupează pe luni și etichetează fiecare grup cu ultima zi a lunii.

2Șir de date lunare

Greșit
PYTHON
zile = pd.date_range("2024-01-01", periods=12, freq="M")
Corect
PYTHON
zile = pd.date_range("2024-01-01", periods=12, freq="MS")

MS dă prima zi a fiecărei luni, ME ultima zi. Alege după ce vrei să reprezinte data.

3Totaluri anuale sau pe oră

Greșit
PYTHON
anual = s.resample("Y").sum()
orar = s.resample("H").sum()
Corect
PYTHON
anual = s.resample("YE").sum()
orar = s.resample("h").sum()

YE e noul cod pentru sfârșit de an, iar h (literă mică) pentru oră.

Repară tu

Repară eroarea, direct în pagină

Codul calculează încasările lunare cu resample("M"), ca în tutorialele mai vechi, și dă ValueError: Invalid frequency: M. Repară-l ca să afișeze totalul pe fiecare lună, etichetat cu ultima zi a lunii, și luna cu cele mai mari încasări.

Codul care dă eroarea
PYTHON
import pandas as pd

df = pd.DataFrame({
    "data": pd.to_datetime(["2024-01-05", "2024-01-19", "2024-02-02", "2024-02-14", "2024-03-08"]),
    "suma": [250, 120, 480, 90, 310],
})

lunar = df.resample("M", on="data")["suma"].sum()
print(lunar)
print("Cea mai bună lună:", lunar.idxmax().strftime("%Y-%m"))
După reparație, programul afișează
data
2024-01-31    370
2024-02-29    570
2024-03-31    310
Freq: ME, Name: suma, dtype: int64
Cea mai bună lună: 2024-02
Indiciu

În pandas 3, sfârșitul de lună se scrie "ME".

Alte forme ale mesajului

  • FutureWarning: 'M' is deprecated and will be removed in a future version, please use 'ME' instead.
  • ValueError: Invalid frequency: Y. Failed to parse with error message: ValueError("'Y' is no longer supported for offsets. Please use 'YE' instead.")
  • FutureWarning: 'H' is deprecated and will be removed in a future version, please use 'h' instead.

Cum o eviți pe viitor

  • Folosește codurile noi: ME/MS pentru lună, QE/QS pentru trimestru, YE/YS pentru an, h, min, s pentru timp.
  • Când copiezi cod de rapoarte lunare dintr-un tutorial, caută "M" în resample, date_range, Grouper și asfreq.
  • Dacă vrei luni ca etichete (2024-01), folosește dt.to_period("M") și groupby, unde M rămâne valid.

Întrebări frecvente

De ce to_period("M") merge, dar resample("M") nu?

Sunt concepte diferite. to_period("M") creează o perioadă (luna întreagă, afișată 2024-01), iar acolo M e codul corect. resample lucrează cu puncte în timp (offset-uri), unde ME înseamnă ultima zi a lunii.

Care e diferența între ME și MS?

Ambele grupează pe luni; diferă eticheta. Cu ME, totalul din ianuarie apare la 2024-01-31; cu MS, la 2024-01-01.

Erori înrudite

← Toate erorile Python pentru analiza datelor

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Python pentru analiza datelor de la zero, cu exerciții la fiecare lecție

Curs Data Analysis with Python: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.