マイクロ秒単位で時系列データを操る！ pandas.tseries.offsets.Micro.apply の完全解説

pandas.tseries.offsets.Micro.apply解説

用途

• 時系列データの分析において、マイクロ秒単位の精度で時間軸を操作したい場合
• マイクロ秒単位のオフセットを持つタイムスタンプを生成したい場合

引数

• offsets: マイクロ秒単位のオフセットを表す数値またはTimedelta型オブジェクト

戻り値

オフセットが適用されたTimedelta型オブジェクト

コード例

import pandas as pd

# マイクロ秒単位のオフセットを生成
offset = pd.tseries.offsets.Micro(500000)

# Timedeltaオブジェクトにオフセットを適用
timestamp = pd.Timestamp("2023-03-08 00:00:00")
new_timestamp = offset.apply(timestamp)

print(new_timestamp)
# Output: Timestamp('2023-03-08 00:00:00.500000')

補足

• pandas.tseries.offsetsモジュールには、マイクロ秒以外にも様々な単位のオフセットを表すクラスが用意されています。

pandas.tseries.offsets.Micro.apply サンプルコード

マイクロ秒単位で時間軸をずらす

import pandas as pd

# データフレームの作成
df = pd.DataFrame({"timestamp": pd.to_datetime(["2023-03-08 00:00:00", "2023-03-08 00:00:01", "2023-03-08 00:00:02"])})

# マイクロ秒単位のオフセットを生成
offset = pd.tseries.offsets.Micro(500000)

# 時間軸を500マイクロ秒ずつずらす
df["timestamp"] = df["timestamp"].apply(offset.apply)

print(df)
# Output:
#        timestamp
# 0 2023-03-08 00:00:00.500000
# 1 2023-03-08 00:00:01.500000
# 2 2023-03-08 00:00:02.500000

マイクロ秒単位のオフセットを持つタイムスタンプを生成

import pandas as pd

# マイクロ秒単位のオフセットを生成
offset = pd.tseries.offsets.Micro(500000)

# 現在時刻にオフセットを適用
timestamp = pd.Timestamp.now().apply(offset.apply)

print(timestamp)
# Output: 2023-03-08 12:34:56.789000

マイクロ秒単位の差を計算

import pandas as pd

# タイムスタンプの作成
timestamp1 = pd.Timestamp("2023-03-08 00:00:00.500000")
timestamp2 = pd.Timestamp("2023-03-08 00:00:01.000000")

# マイクロ秒単位の差を計算
microseconds_diff = (timestamp2 - timestamp1).apply(lambda x: x.microseconds)

print(microseconds_diff)
# Output: 500000

マイクロ秒単位で条件分岐

import pandas as pd

# データフレームの作成
df = pd.DataFrame({"timestamp": pd.to_datetime(["2023-03-08 00:00:00.500000", "2023-03-08 00:00:01.000000", "2023-03-08 00:00:01.500000"])})

# マイクロ秒単位で条件分岐
df["category"] = df["timestamp"].apply(lambda x: "A" if x.microseconds < 500000 else "B")

print(df)
# Output:
#        timestamp category
# 0 2023-03-08 00:00:00.500000        A
# 1 2023-03-08 00:00:01.000000        B
# 2 2023-03-08 00:00:01.500000        B

マイクロ秒単位で時間軸を操作する他の方法

timedelta オブジェクトを使用する

import pandas as pd

# timedelta オブジェクトを作成
offset = pd.Timedelta(microseconds=500000)

# Timedelta オブジェクトを加算する
timestamp = pd.Timestamp("2023-03-08 00:00:00")
new_timestamp = timestamp + offset

print(new_timestamp)
# Output: Timestamp('2023-03-08 00:00:00.500000')

.dt.microsecond プロパティを使用する

import pandas as pd

# データフレームの作成
df = pd.DataFrame({"timestamp": pd.to_datetime(["2023-03-08 00:00:00.500000", "2023-03-08 00:00:01.000000", "2023-03-08 00:00:01.500000"])})

# マイクロ秒を取得
microseconds = df["timestamp"].dt.microsecond

# マイクロ秒に基づいて条件分岐
df["category"] = df["timestamp"].dt.microsecond.apply(lambda x: "A" if x < 500000 else "B")

print(df)
# Output:
#        timestamp category
# 0 2023-03-08 00:00:00.500000        A
# 1 2023-03-08 00:00:01.000000        B
# 2 2023-03-08 00:00:01.500000        B

.dt.floor()