What’s new in 3.2.0 (Month XX, 2027)

These are the changes in pandas 3.2.0. See Release notes for a full changelog including other versions of pandas.

Enhancements

enhancement1

enhancement2

Other enhancements

• Display formatting for complex numbers in object dtype and for interval dtype values with float endpoints now respects the display.precision and display.float_format options (GH 25920).

• The ExtensionArray base tests in pandas.tests.extension.base now issue a errors.PerformanceWarning when the array uses the default, possibly slow, implementation of unique, factorize, argsort, argmin, argmax, or searchsorted (GH 24433)

Notable bug fixes

These are bug fixes that might have notable behavior changes.

notable_bug_fix1

notable_bug_fix2

Backwards incompatible API changes

Increased minimum versions for dependencies

Some minimum supported versions of dependencies were updated. If installed, we now require:

Package	Minimum Version	Required	Changed
		X	X

For optional libraries the general recommendation is to use the latest version. The following table lists the lowest version per library that is currently being tested throughout the development of pandas. Optional libraries below the lowest tested version may still work, but are not considered supported.

Package	Minimum Version	Changed
		X

See Dependencies and Optional dependencies for more.

Other API changes

• Index now displays missing float values as NaN rather than nan in its repr, matching Series and DataFrame (GH 64733)

Deprecations

deprecation1

deprecation2

Other deprecations

• Deprecated pandas.to_pickle, use the DataFrame.to_pickle() or Series.to_pickle() method instead (GH 48402)

• Deprecated the cache_dates argument in read_csv(), read_table(), and read_fwf() (GH 68705)

Performance improvements

• Performance improvement in read_csv() with engine="c" across the board, in tokenizing and in the machinery shared by all column types; large uncompressed local files are additionally read in parallel across multiple CPU cores by default, see above (GH 64347, GH 64515, GH 65350, GH 66271, GH 66272, GH 66273, GH 66274, GH 66276, GH 66798, GH 68314, GH 69632, GH 69748)

• Performance improvement in PeriodIndex.strftime() with a custom date_format (GH 70106)

Bug fixes

Categorical

Datetimelike

• Bug in DataFrame.astype(), Series.astype(), Index.astype(), DatetimeIndex, array() and to_datetime() where float dtype data outside the int64 range, such as inf, silently became a valid-looking datetime64/timedelta64 value or NaT; these now raise OutOfBoundsDatetime/OutOfBoundsTimedelta (GH 68926)

• Bug in DatetimeIndex.strftime(), Series.dt.strftime(), and DataFrame.to_csv() with date_format on Windows silently replacing values that Timestamp.strftime() cannot format (e.g. %y for years before 1900) with their default string representation; these now raise ValueError (GH 58178)

Timedelta

Timezones

Numeric

Conversion

Strings

Interval

• Bug in concat() and Index.append() with IntervalDtype not retaining an extension dtype subtype, either casting it to a NumPy dtype or raising TypeError (GH 64297)

• Bug in Series.shift() and DataFrame.shift() with an IntervalDtype column not retaining the subtype, either changing it or raising TypeError (GH 69922)

Indexing

• Bug in DataFrame.loc() and DataFrame.iloc() setitem on a 1-column DataFrame with an extension dtype raising when the column key is an all-False boolean mask or an empty list-like (GH 70232)

• Bug in DataFrame.loc() and Series.loc() setitem with an integer slice raising TypeError where the same .loc getitem succeeds, e.g. on an index of decimal.Decimal values (GH 70219)

• Bug in Index.difference() dropping elements that are not in other when other was a DatetimeIndex, TimedeltaIndex or PeriodIndex and the elements were strings that parse to its values, or when other was an IntervalIndex and the elements were scalars contained in its intervals (GH 58971)

Missing

MultiIndex

I/O

• Bug in DataFrame.to_parquet() with engine="pyarrow" where a misspelled keyword argument truncated an existing file at the destination or was reported as an error about the path (GH 45815)

• Bug in the repr of a Series or DataFrame with longdouble (e.g. float128) dtype showing values outside the float64 range as 0 or inf (GH 17809)

Period

• Bug in Period.strftime() and PeriodIndex.strftime() where %Y was not zero-padded for years before 1000 on Linux (GH 48746)

Plotting

• Bug in DataFrame.plot() and Series.plot() with kind="bar" or kind="barh" raising TypeError on timedelta64 data containing NaT (GH 39320)

Groupby/resample/rolling

• Bug in Series.resample() and DataFrame.resample() with a PeriodIndex and closed="right" returning shifted labels or incorrect aggregations (GH 44363)

Reshaping

Sparse

ExtensionArray

• Bug in read_csv() and other parsing of strings into a decimal ArrowDtype raising ArrowInvalid instead of parsing the values (GH 69838)

Styler

Other

• Bug in testing.assert_series_equal() and testing.assert_frame_equal() with check_dtype=False and check_exact=True comparing missing values against an object column differently from check_exact=False; pd.NA and NaT no longer match np.nan or None (GH 61473)

• Bug in DataFrame.query() and DataFrame.eval() where == and != against a string gave different results than the same comparison outside of query, e.g. returning no rows for a datetime64, timedelta64, or PeriodDtype column, or raising NotImplementedError with parser="python" (GH 54199)

Contributors

A total of 10 people contributed patches to this release. People with a “+” by their names contributed a patch for the first time.

• Claude Opus 5

• Claude Opus 5.5

• Joris Van den Bossche

• Julian Harbeck

• N3verm1nd

• Richard Shadrach

• Vincent Ngo +

• dependabot[bot]

• jbrockmendel

• ump45nose