L'objet DateOffset de Pandas est un outil utilisé pour effectuer des décalages temporels lors du traitement des données de date et d'heure.

Voici quelques caractéristiques et utilisations clés de DateOffset :

Concepts de base

L'objet DateOffset est similaire à Timedelta, mais il suit des règles de date et d'heure basées sur le calendrier plutôt que d'effectuer directement des calculs arithmétiques de nature temporelle. Cela signifie que DateOffset prend en compte les jours calendaires réels. Par exemple, lorsqu'il traite des dates à cheval sur des mois ou des années, il calcule correctement les différences de jours, alors que Timedelta ajoute simplement le nombre de jours spécifié sans tenir compte des changements de mois et d'années.

Utilisation

DateOffset peut effectuer des opérations de décalage de date via des opérateurs arithmétiques (tels que +) ou la méthode apply.

Par exemple, vous pouvez utiliser DateOffset comme ceci pour ajouter des mois ou des heures :

Exemples

ts = pd.Timestamp('2017-01-01 09:10:11')
ts + DateOffset(months=3)  # Ajouter trois mois
ts + DateOffset(hours=2)   # Ajouter deux heures

Si aucun paramètre n'est spécifié, DateOffset() ajoute un jour par défaut :

ts + DateOffset()  # 默认增加一天

Paramètres par défaut

DateOffset prend en charge plusieurs paramètres, ce qui vous permet de spécifier des unités de temps à ajouter ou à remplacer, telles que des années, des mois, des semaines, des jours, des heures, des minutes, des secondes, etc. Ces paramètres peuvent être ajoutés au décalage (tels que années, mois, semaines, jours, heures, minutes, secondes, etc.), ou ils peuvent remplacer le décalage (tels que année, mois, jour, jour de la semaine, heure, minute, etc.).

Méthodes spéciales

DateOffset fournit également les méthodes rollforward() et rollback(), qui sont utilisées pour avancer ou reculer les dates jusqu'à la date valide la plus proche. Si vous utilisez un décalage en jours ouvrés (BDay), il ignorera les week-ends et passera directement au jour ouvré suivant.

Exemples

friday = pd.Timestamp('2022-01-05')
two_business_days = 2 pd.offsets.BDay()
two_business_days  Ajouter deux jours ouvrés, en ignorant les week-ends

Chaînes de fréquence

DateOffset prend en charge les chaînes de fréquence ou les alias de décalage, qui peuvent être passés en tant que paramètre freq. Ces chaînes de fréquence représentent des objets DateOffset et leurs sous-classes, et elles définissent la fréquence des index datetime.

DateOffset est un outil très utile dans Pandas pour le traitement des données de séries temporelles, car il rend les opérations de décalage de date et d'heure plus cohérentes avec les règles du calendrier réel.


Fonctions courantes

Constructeur de DateOffset

Classe/Méthode Description
pd.DateOffset(**kwargs) Créer un objet DateOffset, prenant en charge des décalages temporels personnalisés.

Sous-classes courantes de DateOffset

Classe Description
pd.offsets.Day() Représente un décalage en jours.
pd.offsets.BDay() Représente un décalage en jours ouvrés (hors week-ends).
pd.offsets.Hour() Représente un décalage en heures.
pd.offsets.Minute() Représente un décalage en minutes.
pd.offsets.Second() Représente un décalage en secondes.
pd.offsets.Milli() Représente un décalage en millisecondes.
pd.offsets.Micro() Représente un décalage en microsecondes.
pd.offsets.MonthEnd() Représente un décalage de fin de mois.
pd.offsets.MonthBegin() Représente un décalage de début de mois.
pd.offsets.YearEnd() Représente un décalage de fin d'année.
pd.offsets.YearBegin() Représente un décalage par rapport au début de l'année.
pd.offsets.QuarterEnd() Représente un décalage par rapport à la fin du trimestre.
pd.offsets.QuarterBegin() Représente un décalage par rapport au début du trimestre.
pd.offsets.Week() Représente un décalage en semaines.
pd.offsets.WeekOfMonth() Représente un décalage de la n-ième semaine du mois.

Attributs de DateOffset

Attribut Description
DateOffset.name Renvoie le nom de DateOffset.
DateOffset.n Renvoie ou définit le nombre de décalages.
DateOffset.normalize Renvoie ou définit s'il faut normaliser l'heure à minuit.

Méthodes de DateOffset

Méthode Description
DateOffset.apply(other) Applique le décalage à un autre objet datetime.
DateOffset.rollforward(other) Avance la date jusqu'au décalage suivant.
DateOffset.rollback(other) Reculer la date vers l'offset précédent.
DateOffset.is_anchored() Vérifier si l'offset est ancré (c'est-à-dire s'il a une fréquence fixe).
DateOffset.onOffset(date) Vérifier si la date est alignée avec l'offset.

Exemples

Exemples

import pandas as pd
from pandas.tseries.offsets import Day, BDay, MonthEnd

# Créer DateOffset
offset = Day(3)
print(offset)  # Sortie <3 * Days>

# Appliquer DateOffset
date = pd.Timestamp('2023-01-01')
new_date = date + offset
print(new_date)  # Sortie 2023-01-04

# Utiliser une sous-classe commune
bday_offset = BDay(2)
new_bdate = date + bday_offset
print(new_bdate)  # Sortie 2023-01-05 (en sautant les week-ends)

# Décalage de fin de mois
month_end_offset = MonthEnd()
new_month_end = date + month_end_offset
print(new_month_end)  # Sortie 2023-01-31

Description détaillée des paramètres

pd.DateOffset()

Paramètre Description
years Nombre d'années de décalage.
months Nombre de mois de décalage.
weeks Nombre de semaines de décalage.
days Nombre de jours de décalage.
hours Nombre d'heures de décalage.
minutes Nombre de minutes de décalage.
seconds Nombre de secondes de décalage.
milliseconds Nombre de millisecondes de décalage.
microseconds Nombre de microsecondes de décalage.
nanoseconds Nombre de nanosecondes de décalage.

pd.offsets.BDay()

Paramètre Description
n Le nombre de décalages, par défaut à 1.
normalize S'il faut normaliser l'heure à minuit, par défaut àFalse。

pd.offsets.MonthEnd()

Paramètre Description
n Le nombre de décalages, par défaut à 1.
normalize S'il faut normaliser l'heure à minuit, par défaut àFalse。

Pour plus d'informations détaillées, veuillez consulter laDocumentation officielle de Pandas。

Autres extensions