API · Pandas

Pandas DataFrame.resample() 函式

使用 DataFrame.resample() 將時間序列觀測值分組到指定頻率的區間,以便進行彙總。

本頁內容

Python Pandas 的 DataFrame.resample() 會將帶有時間索引的觀測值分組到指定頻率的區間,方便你進行彙總,例如計算每週或每月的總和。

pandas.DataFrame.resample() 的語法

DataFrame 方法會使用類似日期時間的索引重新取樣資料列;你也可以透過 on 或 level,選取類似日期時間的欄位或索引層級。此方法的完整簽章會隨 pandas 版本而異;核心呼叫形式為 df.resample(rule, ...),其中 rule 指定目標頻率。本文未指定 pandas 執行環境的版本,因此刻意省略版本限定的預設值與參數。

參數

參數 用途
rule 定義目標區間的頻率規則。
closed 指定每個區間包含哪一側的邊界。
label 指定用哪一側的區間邊界標記各項結果。
on 選取類似日期時間的 DataFrame 欄位進行分組,而不使用索引。
level 選取 MultiIndex 中類似日期時間的層級進行分組。
origin 和 offset 調整區間的起始位置;可接受的值與行為會依 pandas 版本而異。

回傳值

resample() 會回傳 resampler 物件。你可以接續呼叫 .sum() 等彙總方法,產生各區間的結果。DataFrame.resample() 是用於 DataFrame 的方法;下方範例使用 Series,因此呼叫的是 Series.resample()。本資料包沒有提供 pandas 執行版本或執行證據,所以下方範例尚未執行,也不會宣稱任何實際觀察到的輸出。

每週重新取樣範例

這個 Series 包含 2021 年 1 月 1 日至 1 月 30 日每天的一個值。每週頻率規則會將這些每日數值分組到每週區間,再由 .sum() 加總各區間中的數值。如程式碼所示,週區間以週日結束並以該日標記;由於輸入日期從星期五開始、在星期六結束,第一個和最後一個區間都只涵蓋部分星期。

import pandas as pd

dates = pd.date_range("2021-01-01", periods=30, freq="D")
daily = pd.Series(range(30), index=dates)
weekly_totals = daily.resample("W").sum()
print(weekly_totals)

此程式片段未實際執行;它示範了 Series 操作與輸入資料,供你調整彙總方式時參考。

每月重新取樣範例

同一個每日 Series 也可以依曆月分組並加總。這段程式碼計算輸入中 1 月 1 日至 1 月 30 日觀測值的總和:數值從 0 到 29,因此總和為 435。由於輸入資料沒有 1 月 31 日的觀測值,這不是完整月份的彙總。MonthEnd() 可表示以月底為界的頻率規則,不必依賴其支援情況可能因 pandas 版本而異的頻率別名。

import pandas as pd

dates = pd.date_range("2021-01-01", periods=30, freq="D")
daily = pd.Series(range(30), index=dates)
monthly_totals = daily.resample(pd.offsets.MonthEnd()).sum()
print(monthly_totals)

此程式片段未實際執行;結果說明是根據提供的數值推得,本文不主張任何 pandas 版本特定的輸出格式。