API · Pandas

Función Pandas DataFrame.resample()

DataFrame.resample() agrupa observaciones indexadas por tiempo en intervalos de frecuencia para agregarlas.

En esta página

Python Pandas DataFrame.resample() agrupa observaciones indexadas por tiempo en intervalos de frecuencia para poder agregarlas, por ejemplo, sumando los valores de cada semana o mes.

Sintaxis de pandas.DataFrame.resample()

El método de DataFrame vuelve a muestrear filas mediante un índice de tipo fecha y hora, o una columna o nivel del índice de ese tipo que se seleccione con on o level. La firma exacta varía según la versión de pandas; la llamada básica es df.resample(rule, ...), donde rule especifica la frecuencia de destino. Como aquí no se indica una versión de pandas, se omiten deliberadamente los parámetros y valores predeterminados específicos de cada versión.

Parámetros

Parámetro Propósito
rule Regla de frecuencia que define los intervalos de destino.
closed Elige qué lado de cada intervalo se incluye.
label Elige qué extremo del intervalo etiqueta cada resultado.
on Selecciona una columna de DataFrame de tipo fecha y hora para agrupar en lugar del índice.
level Selecciona un nivel de tipo fecha y hora de un MultiIndex para agrupar.
origin y offset Ajustan el punto de inicio de los intervalos; los valores aceptados y su comportamiento dependen de la versión de pandas.

Retorno

resample() devuelve un objeto resampler. Se puede encadenar una agregación, como .sum(), para obtener un resultado por intervalo. DataFrame.resample() opera sobre un DataFrame; los ejemplos siguientes usan una Series y, por tanto, llaman a Series.resample(). En este paquete los ejemplos no se han ejecutado: no se proporciona una versión de pandas ni evidencia de ejecución, así que no se afirma ningún resultado observado.

Ejemplo de remuestreo semanal

Esta Series contiene un valor por cada fecha entre el 1 y el 30 de enero de 2021. La regla semanal agrupa esos valores diarios en intervalos semanales y .sum() suma los valores de cada intervalo. Con la regla semanal que termina en domingo mostrada, las etiquetas son los domingos que cierran cada intervalo; el primer y el último intervalo son parciales porque las fechas proporcionadas empiezan en viernes y terminan en sábado.

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)

Este fragmento no constituye evidencia de ejecución; muestra la operación sobre Series y los datos de entrada necesarios para adaptar la agregación.

Ejemplo de remuestreo mensual

La misma Series diaria se puede agrupar en un intervalo de mes natural y sumar. Este código calcula la suma de las observaciones proporcionadas del 1 al 30 de enero: los valores van de 0 a 29, por lo que suman 435. No es un agregado del mes completo porque la entrada no incluye una observación del 31 de enero. MonthEnd() expresa la regla de fin de mes sin depender de un alias de frecuencia cuya compatibilidad puede variar según la versión de 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)

Este fragmento no constituye evidencia de ejecución; el resultado se describe a partir de los valores proporcionados y no se afirma ningún formato específico de una versión de pandas.