如何解决 yfinance 中 pd.to_timedelta 弃用警告问题

在使用yfinance库获取股票等金融数据的过程中，部分用户会发现控制台频繁弹出pd.to_timedelta相关的弃用警告，这类警告通常出现在pandas版本升级到2.0及以上时，旧的时间间隔转换语法不再被推荐使用。要解决这个问题，首先需要明确警告的触发场景，再针对性调整代码或依赖版本。

警告产生的原因

pd.to_timedelta是pandas中用于转换时间间隔的函数，在pandas 2.0版本之前，很多开发者会用pd.to_timedelta配合字符串参数来生成时间间隔对象。但新版本中，pandas官方更推荐使用pd.Timedelta类直接构造时间间隔，因此旧的函数调用方式会被标记为弃用，yfinance部分旧版本代码恰好使用了这类旧语法，就会触发警告。

解决方案一：修改代码中的时间间隔转换逻辑

如果不需要固定yfinance的版本，可以手动调整代码中涉及时间间隔转换的部分，将pd.to_timedelta替换为pd.Timedelta。以下是示例对比：

旧写法（触发警告）

import pandas as pd
import yfinance as yf

# 旧的时间间隔转换方式
time_delta = pd.to_timedelta("1d")
data = yf.download("AAPL", start="2024-01-01", end="2024-01-10")
# 使用时间间隔做数据筛选
filtered_data = data[data.index >= data.index[-1] - time_delta]
print(filtered_data)

新写法（无警告）

import pandas as pd
import yfinance as yf

# 新的时间间隔转换方式
time_delta = pd.Timedelta("1d")
data = yf.download("AAPL", start="2024-01-01", end="2024-01-10")
# 使用时间间隔做数据筛选
filtered_data = data[data.index >= data.index[-1] - time_delta]
print(filtered_data)

如果警告是yfinance内部代码触发的，可以升级yfinance到最新版本，官方通常会在新版本中适配pandas的语法更新，修复这类弃用问题。升级命令如下：

pip install --upgrade yfinance

解决方案二：固定pandas版本

如果项目对pandas版本有严格要求，无法升级到2.0以上，或者暂时不想修改代码逻辑，可以固定pandas的版本到1.x系列的最新版本，该版本仍然支持pd.to_timedelta的旧语法，不会触发弃用警告。安装指定版本的命令如下：

pip install pandas==1.5.3

安装完成后，重新运行yfinance相关的代码，弃用警告就会消失。不过这种方式只是临时解决方案，长期来看还是建议适配新版本pandas的语法，避免后续版本升级带来更多兼容性问题。

验证解决效果

修改完成后，可以运行以下简单测试代码，确认警告是否已经被消除：

import pandas as pd
import yfinance as yf
import warnings

# 捕获所有警告，方便查看是否还有弃用提示
with warnings.catch_warnings(record=True) as w:
    warnings.simplefilter("always")
    data = yf.download("AAPL", start="2024-01-01", end="2024-01-05")
    # 筛选包含pd.to_timedelta相关的警告
    target_warnings = [warn for warn in w if "to_timedelta" in str(warn.message)]
    if not target_warnings:
        print("未检测到pd.to_timedelta相关弃用警告，问题已解决")
    else:
        print("仍存在相关警告，请检查修改是否生效")

通过以上两种方式，基本可以解决yfinance中pd.to_timedelta的弃用警告问题，开发者可以根据项目的实际情况选择合适的方案。

yfinancepd.to_timedeltapandas弃用警告修改时间：2026-06-09 09:51:22