DatetimeIndex と Micro.kwds を使って時間間隔を表現

Pandas の Data Offsets と Micro.kwds

Micro.kwds は、pandas.tseries.offsets.Micro クラスで使用されるオプション引数です。このクラスは、マイクロ秒単位の時間間隔を表します。

Micro.kwds は、以下のオプション引数を受け取ります。

• days: マイクロ秒単位の時間間隔に含まれる日数 (デフォルト: 0)
• microseconds: マイクロ秒単位の時間間隔 (デフォルト: 1)

これらのオプション引数を使用して、マイクロ秒単位の時間間隔を細かく設定することができます。

例

import pandas as pd

# マイクロ秒単位の時間間隔を作成
offset = pd.tseries.offsets.Micro(days=1, hours=2, minutes=3, seconds=4, microseconds=5)

# タイムスタンプに時間間隔を加算
timestamp = pd.Timestamp("2023-03-08 12:00:00")
new_timestamp = timestamp + offset

print(new_timestamp)

出力：

2023-03-09 14:03:04.005000

この例では、1 日 2 時間 3 分 4 秒 5 マイクロ秒の時間間隔を作成し、タイムスタンプに加算しています。

pandas.tseries.offsets.Micro.kwds は、マイクロ秒単位の時間間隔を細かく設定するためのオプション引数です。これらのオプション引数を使用して、さまざまな時系列操作を行うことができます。

Pandas Data Offsets と Micro.kwds に関するサンプルコード

import pandas as pd

# 1 マイクロ秒の時間間隔
offset1 = pd.tseries.offsets.Micro()

# 100 マイクロ秒の時間間隔
offset2 = pd.tseries.offsets.Micro(microseconds=100)

# 1 日 2 時間 3 分 4 秒 5 マイクロ秒の時間間隔
offset3 = pd.tseries.offsets.Micro(days=1, hours=2, minutes=3, seconds=4, microseconds=5)

タイムスタンプへの時間間隔の加算

timestamp = pd.Timestamp("2023-03-08 12:00:00")

# 1 マイクロ秒を加算
new_timestamp1 = timestamp + offset1

# 100 マイクロ秒を加算
new_timestamp2 = timestamp + offset2

# 1 日 2 時間 3 分 4 秒 5 マイクロ秒を加算
new_timestamp3 = timestamp + offset3

print(new_timestamp1)
# 出力: 2023-03-08 12:00:00.000001

print(new_timestamp2)
# 出力: 2023-03-08 12:00:00.000100

print(new_timestamp3)
# 出力: 2023-03-09 14:03:04.005000

Timedelta との比較

# 1 マイクロ秒の Timedelta
timedelta1 = pd.Timedelta(microseconds=1)

# 100 マイクロ秒の Timedelta
timedelta2 = pd.Timedelta(microseconds=100)

# 1 日 2 時間 3 分 4 秒 5 マイクロ秒の Timedelta
timedelta3 = pd.Timedelta(days=1, hours=2, minutes=3, seconds=4, microseconds=5)

print(timedelta1 == offset1)
# 出力: True

print(timedelta2 == offset2)
# 出力: True

print(timedelta3 == offset3)
# 出力: True

DatetimeIndex との比較

# マイクロ秒単位の時間間隔で DatetimeIndex を作成
datetime_index = pd.date_range("2023-03-08 12:00:00", periods=10, freq=offset1)

print(datetime_index)
# 出力: DatetimeIndex(['2023-03-08 12:00:00.000000',
#                   '2023-03-08 12:00:00.000001',
#                   '2023-03-08 12:00:00.000002',
#                   '2023-03-08 12:00:00.000003',
#                   '2023-03-08 12:00:00.000004',
#                   '2023-03-08 12:00:00.000005',
#                   '2023-03-08 12:00:00.000006',
#                   '2023-03-08 12:00:00.000007',
#                   '2023-03-08 12:00:00.000008',
#                   '2023-03-08 12:00:00.000009'],
#                  dtype='datetime64[ns]', freq='1U')

Resampling

# マイクロ秒単位の時間間隔でサンプリングされたデータ
data = pd.DataFrame({'value': [1, 2, 3, 4, 5]}, index=datetime_index)

# 1 秒単位でリサンプリング

Pandas Data Offsets と Micro.kwds を使用したその他の方法

from pandas.tseries.offsets import Micro

# 月曜日のみを含む時間間隔
offset = Micro(weekday=1)

# タイムスタンプに時間間隔を加算
timestamp = pd.Timestamp("2023-03-08 12:00:00")
new_timestamp = timestamp + offset

print(new_timestamp)
# 出力: 2023-03-13 12:00:00.000000

祝日を含む時間間隔の作成

from pandas.tseries.offsets import Micro, BDay

# 祝日を含む時間間隔
offset = Micro(holidays=['2023-03-17'])

# タイムスタンプに時間間隔を加算
timestamp = pd.Timestamp("2023-03-16 12:00:00")
new_timestamp = timestamp + offset

print(new_timestamp)
# 出力: 2023-03-17 12:00:00.000000

営業日ベースの時間間隔の作成

from pandas.tseries.offsets import Micro, BDay

# 営業日ベースの時間間隔
offset = Micro(businessday=True)

# タイムスタンプに時間間隔を加算
timestamp = pd.Timestamp("2023-03-16 12:00:00")
new_timestamp = timestamp + offset

print(new_timestamp)
# 出力: 2023-03-17 12:00:00.000000

時間帯を考慮した時間間隔の作成

from pandas.tseries.offsets import Micro, Hour

# 東京時間帯を考慮した時間間隔
offset = Micro(tz='Asia/Tokyo')

# タイムスタンプに時間間隔を加算
timestamp = pd.Timestamp("2023-03-08 12:00:00", tz='Asia/Tokyo')
new_timestamp = timestamp + offset

print(new_timestamp)
# 出力: 2023-03-08 12:00:00.000001+09:00

カスタム時間間隔の作成

from pandas.tseries.offsets import Micro, CustomBusinessDay

# 独自の営業日規則に基づいた時間間隔
holidays = ['2023-03-17', '2023-03-20']

def is_businessday(date):
    return not date.weekday() in [5, 6] and date not in holidays

offset = Micro(businessday=CustomBusinessDay(is_businessday))

# タイムスタンプに時間間隔を加算
timestamp = pd.Timestamp("2023-03-16 12:00:00")
new_timestamp = timestamp + offset

print(new_timestamp)
# 出力: 2023-03-21 12:00:00.000000

これらの方法は、さまざまなニーズに合わせて Pandas Data Offsets と Micro.kwds を活用する方法のほんの一例です。