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 + 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
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
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