0.23¶

废弃(未来版本可能会删除)¶

• Series.from_array和SparseSeries.from_array已弃用。请使用普通构造函数Series(..)和SparseSeries(..)(GH18213)。
• DataFrame.as_matrix已弃用。请使用DataFrame.values替代(GH18458)。
• Series.asobject，DatetimeIndex.asobject，PeriodIndex.asobject和TimeDeltaIndex.asobject已被弃用。请使用.astype(object)替代(GH18572)
• Grouping by a tuple of keys now emits a FutureWarning and is deprecated. In the future, a tuple passed to 'by' will always refer to a single key that is the actual tuple, instead of treating the tuple as multiple keys. To retain the previous behavior, use a list instead of a tuple (GH18314)
• Series.valid已弃用。请使用Series.dropna()替代(GH18800)。
• read_excel()已弃用参数skip_footer。请使用skipfooter替代(GH18836)
• ExcelFile.parse()已弃用参数sheetname，请使用与read_excel()(GH20920)一致的sheet_name参数。
• is_copy属性已弃用，将在以后的版本中移除(GH18801)。
• IntervalIndex.from_intervals不推荐使用IntervalIndex构造函数(GH19263)
• DataFrame.from_items已弃用。请使用DataFrame.from_dict()，如果您希望保留按键顺序，请使用DataFrame.from_dict(OrderedDict())(GH17320，GH17312)
• 使用包含一些缺失键的列表索引MultiIndex或FloatIndex现在将提示FutureWarning，这与其他类型的索引一致(GH17758)。
• 不推荐使用.apply()的参数broadcast，请使用result_type ='broadcast'(GH18577)
• 不推荐使用.apply()的参数reduce，请使用result_type ='reduce'(GH18577)
• factorize()的order参数已弃用，将在以后的版本中删除(https://github.com/pandas-dev/pandas/issues/19727))
• Timestamp.weekday_name，DatetimeIndex.weekday_name和Series.dt.weekday_name已弃用，请使用Timestamp.day_name()，`DatetimeIndex.day_name()和Series.dt.day_name()(GH12806)
• pandas.tseries.plotting.tsplot已弃用。请使用Series.plot()替代(GH18627)
• Index.summary()已弃用，将在以后的版本中删除(GH18217)
• NDFrame.get_ftype_counts()已弃用，将在以后的版本中删除(GH18243)
• DataFrame.to_records()中的convert_datetime64参数已弃用，将在以后的版本中删除。 使用该参数的NumPy错误已得到解决。 此参数的默认值也已从True更改为None(https://github.com/pandas-dev/pandas/issues/18160)
• Series.rolling().apply()，DataFrame.rolling().apply()，Series.expanding().apply()和DataFrame.expanding()/apply()已弃用默认情况下传递np.array。 需要传递新的原始参数以明确传递的内容(GH20584)
• 不推荐使用Series和Index类的base，strides，flags和itemsize属性，将来的版本将删除它们。(GH20419)。
• DatetimeIndex.offset已弃用。请使用DatetimeIndex.freq替代(GH20716)
• 整数ndarray和Timedelta之间的除法已启用。 请使用Timedelta.value(GH19761)
• 不建议使用设置PeriodIndex.freq(无法保证正常工作)。请使用PeriodIndex.asfreq()替代(GH20678)
• Index.get_duplicates()已弃用，将在以后的版本中删除(GH20239)
• The previous default behavior of negative indices in Categorical.take is deprecated. In a future version it will change from meaning missing values to meaning positional indices from the right. The future behavior is consistent with Series.take()(GH20664)
• 将多个轴传递给DataFrame.dropna()中的axis参数已被弃用，将在以后的版本中删除(GH20987)

移除或修改¶

• 针对使用过时的警告分类（代码，类别），例如当Categorical（）的前两个参数具有不同的dtypes时发出，并且建议使用Categorical.from_codes，现在已被删除(GH8074)
• MultiIndex的levels和labels属性不能再直接设置（GH4039）。
• pd.tseries.util.pivot_annual已删除（自v0.19以来已弃用）。使用pivot_table替代（GH18370）
• pd.tseries.util.isleapyear已删除（自v0.19以来已弃用）。请使用Datetime-like的is_leap_year属性（GH18370）
• pd.ordered_merge已删除（自v0.19以来已弃用）。使用pd.merge_ordered替代（GH18459）
• SparseList类已被删除（GH14007）
• pandas.io.wb和pandas.io.data的存根模块已经被移除（GH13735）
• Categorical.from_array已被删除（GH13854）
• freq和how参数已经从DataFrame和Series的rolling/ expanding/ ewm方法中移除（自v0.18不建议使用）。请调用方法之前重新采样。（GH18601和GH18668）
• DatetimeIndex.to_datetime，Timestamp.to_datetime，PeriodIndex.to_datetime和Index.to_datetime已经被移除（GH8254，GH14096，GH14113）
• read_csv()已删除skip_footer参数（GH13386）
• read_csv()已删除as_recarray参数（GH13373）
• read_csv()已删除buffer_lines参数（GH13360）
• read_csv()已下删除参数compact_ints和use_unsigned（GH13323）
• Timestamp已移除offset属性，请使用属性freq（GH13593）
• Series，Categorical和Index 已删除reshape方法（GH13012）
• pandas.tseries.frequencies.get_standard_freq已被删除，请使用pandas.tseries.frequencies.to_offset(freq).rule_code（GH13874）
• pandas.tseries.frequencies.to_offset已删除关键字freqstr，请使用freq（GH13874）
• 类Panel4D和类PanelND已被删除（GH13776）
• Panel类已移除to_long和toLong方法（GH19077）
• 选项display.line_with和display.height已移除，请使用display.width和display.max_rows（GH4391，GH19107）
• Categorical类的labels属性已被删除，请使用Categorical.codes（GH7768）
• flavor参数已从to_sql方法中删除（GH13611）
• pandas.tools.hashing和pandas.util.hashing已经被移除（GH16223）
• 顶层方法pd.rolling_*，pd.expanding_和pd.ewm已经被移除（因为v0.18弃用）。请使用DataFrame,Series的方法rolling，expanding和ewm（GH18723）
• 删除了从pandas.core.common导入的方法，比如is_datetime64_dtype。这些方法现在位于pandas.api.types。（GH13634，GH19769）
• Series.tz_localize(), DatetimeIndex.tz_localize() 和 DatetimeIndex中的infer_dst参数已移除，infer_dst = True相当于ambiguous ='infer'，infer_dst = False to ambiguous ='raise'（GH7963）。
• 当.resample()从一个渴望变为一个懒惰的操作时，就像.groupby()在v0.18.0中一样，我们实现了兼容性（带有a FutureWarning），因此操作在早前版本依然有效。现已失效，因此Resampler将不再转发compat操作（GH20554）
• .replace方法移除了参数axis=None（GH20271）

0.22¶

无

0.21¶

废弃(未来版本可能会删除)¶

• 不推荐使用DataFrame.from_csv() 和 Series.from_csv()，用read_csv()替代 (GH4191)
• read_excel()弃用sheetname参数，启用和to_csv()一致的sheet_name参数 (GH10559)
• read_excel()弃用parse_cols参数，启用和to_csv()一致的usecol`参数 (GH4988)
• read_csv() 弃用tupleize_cols参数，Column tuples将始终转换为MultiIndex (GH17060)
• DataFrame.to_csv()弃用tupleize_cols参数. MultiIndex columns将始终写为CSV文件中的行 (GH17060)
• 转换参数已在.take()方法中弃用，因为它未得到遵守（文档字符串相关，对代码无影响） (GH16948)
• pd.options.html.border已被弃用，请使用pd.options.display.html.border (GH15793)
• SeriesGroupBy.nth()已弃用True，因为它的kwarg dropna支持'all' (GH11038)
• 不推荐使用DataFrame.as_blocks()，因为它暴露了内部实现 (GH17302)
• 不推荐使用pd.TimeGrouper，请使用pandas.Grouper (GH16747)
• cdate_range已被弃用，请使用bdate_range()，它已获得用于构建自定义频率日期范围的周掩码和假日参数。(GH17596)
• 不推荐将类别或有序的kwargs传递给Series.astype()，而是支持传递CategoricalDtype (GH17636)

移除或修改¶

• 不推荐在Series，DataFrame，Panel，SparseSeries和SparseDataFrame上使用.get_value和.set_value，转而使用.iat []或.at []访问器 (GH15269)
• 不推荐在.to_excel(...,columns =)中传递不存在的列，在将来的版本，这将会引发KeyError (GH17295)
• 不推荐使用raise_on_error参数到Series.where()，Series.mask()，DataFrame.where()，DataFrame.mask()，以支持错误 (GH14968)
• 不推荐使用DataFrame.rename_axis()和Series.rename_axis()来更改索引或列标签，而是使用.rename。 rename_axis仍可用于更改索引或列的名称(GH17833)
• reindex_axis()已被弃用，请使用reindex()(17833)
• pandas.tseries.register已重命名为pandas.plotting.register_matplotlib_converters() (GH18301)
• read_excel()移除has_index_names参数（GH10967）
• 移除pd.options.display.height配置（GH3663）
• 移除pd.options.display.line_width配置（GH2881）
• 移除pd.options.display.mpl_style配置（GH12190）
• Index移除了.sym_diff()方法，请使用.symmetric_difference()（GH12591）的方法
• Categorical移除了.order()和.sort()方法，请使用.sort_values()（GH12882）
• eval()和DataFrame.eval()参数inplace的默认值None调整为False（GH11149）
• 移除了get_offset_name方法，请使用offset的.freqstr属性（GH11834）
• pandas不再测试与使用pandas <0.11（GH17404）创建的hdf5文件的兼容性。