pandas.tseries.offsets.CustomBusinessHour.nanos 属性の詳細解説

pandas.tseries.offsets.CustomBusinessHour.nanos の詳細解説

pandas.tseries.offsets.CustomBusinessHour.nanos は、pandas ライブラリの CustomBusinessHour クラスで使用される属性です。この属性は、ナノ秒単位のカスタムビジネス時間のオフセットを設定するために使用されます。

機能

CustomBusinessHour クラスは、祝日や営業時間などを考慮した、カスタムなビジネス時間のオフセットを作成するために使用されます。nanos 属性は、このオフセットにナノ秒単位の精度を追加するために使用できます。

例

以下の例では、nanos 属性を使用して、午前9時から午後5時までの営業時間を表すカスタムビジネス時間のオフセットを作成しています。

from pandas.tseries.offsets import CustomBusinessHour

# 午前9時から午後5時までの営業時間を表すオフセットを作成
business_hours = CustomBusinessHour(start="09:00", end="17:00", nanos=100000000)

# オフセットを適用
timestamp = pd.Timestamp("2023-03-08 09:00:00")
new_timestamp = timestamp + business_hours

# 結果: 2023-03-08 10:00:00.000000001
print(new_timestamp)

注意事項

• nanos 属性は、CustomBusinessHour クラスのオプション属性です。デフォルト値は0です。
• nanos 属性は、start 属性と end 属性で指定された時間範囲内にのみ適用されます。
• nanos 属性は、他の DateOffset オブジェクトと組み合わせて使用することができます。

補足

• nanos 属性は、非常に高精度な時間操作が必要な場合にのみ使用することをお勧めします。
• ほとんどの場合、minutes や seconds などの他の属性で十分な精度を得ることができます。

pandas.tseries.offsets.CustomBusinessHour.nanos を使用したサンプルコード

祝日を含むオフセットの作成

from pandas.tseries.offsets import CustomBusinessHour

# 祝日リスト
holidays = ["2023-03-09", "2023-03-10"]

# 午前9時から午後5時までの営業時間を表すオフセットを作成
business_hours = CustomBusinessHour(start="09:00", end="17:00", holidays=holidays, nanos=100000000)

# オフセットを適用
timestamp = pd.Timestamp("2023-03-08 09:00:00")
new_timestamp = timestamp + business_hours

# 結果: 2023-03-08 10:00:00.000000001
print(new_timestamp)

異なる開始時間と終了時間を持つオフセットの作成

from pandas.tseries.offsets import CustomBusinessHour

# 午前10時から午後4時までの営業時間を表すオフセットを作成
business_hours = CustomBusinessHour(start="10:00", end="16:00", nanos=100000000)

# オフセットを適用
timestamp = pd.Timestamp("2023-03-08 09:00:00")
new_timestamp = timestamp + business_hours

# 結果: 2023-03-08 10:00:00.000000001
print(new_timestamp)

他の DateOffset オブジェクトとの組み合わせ

from pandas.tseries.offsets import CustomBusinessHour, Day

# 午前9時から午後5時までの営業時間を表すオフセットを作成
business_hours = CustomBusinessHour(start="09:00", end="17:00", nanos=100000000)

# 2営業日後の午前9時を指定
offset = business_hours * 2 + Day(1)

# オフセットを適用
timestamp = pd.Timestamp("2023-03-08 09:00:00")
new_timestamp = timestamp + offset

# 結果: 2023-03-13 09:00:00.000000001
print(new_timestamp)

pandas.tseries.offsets.CustomBusinessHour.nanos 以外の方法

pandas.tseries.offsets.Nano() オブジェクトを使用する

from pandas.tseries.offsets import CustomBusinessHour, Nano

# 午前9時から午後5時までの営業時間を表すオフセットを作成
business_hours = CustomBusinessHour(start="09:00", end="17:00")

# ナノ秒オフセットを作成
nano_offset = Nano(100000000)

# オフセットを結合
combined_offset = business_hours + nano_offset

# オフセットを適用
timestamp = pd.Timestamp("2023-03-08 09:00:00")
new_timestamp = timestamp + combined_offset

# 結果: 2023-03-08 09:00:00.000000001
print(new_timestamp)

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

from pandas import Timedelta

# 午前9時から午後5時までの営業時間を表すオフセットを作成
business_hours = CustomBusinessHour(start="09:00", end="17:00")

# ナノ秒オフセットを作成
nano_offset = Timedelta(nanoseconds=100000000)

# オフセットを結合
combined_offset = business_hours + nano_offset

# オフセットを適用
timestamp = pd.Timestamp("2023-03-08 09:00:00")
new_timestamp = timestamp + combined_offset

# 結果: 2023-03-08 09:00:00.000000001
print(new_timestamp)

自作の関数を使用する

def my_custom_business_hour(start, end, nanos):
  """
  カスタムビジネス時間のオフセットを作成する関数

  Args:
    start: 営業開始時間
    end: 営業終了時間
    nanos: ナノ秒オフセット

  Returns:
    CustomBusinessHour オブジェクト
  """

  business_hours = CustomBusinessHour(start=start, end=end)
  nano_offset = Timedelta(nanoseconds=nanos)

  return business_hours + nano_offset

# 午前9時から午後5時までの営業時間を表すオフセットを作成
offset = my_custom_business_hour("09:00", "17:00", 100000000)

# オフセットを適用
timestamp = pd.Timestamp("2023-03-08 09:00:00")
new_timestamp = timestamp + offset

# 結果: 2023-03-08 09:00:00.000000001
print(new_timestamp)

これらの方法は、pandas.tseries.offsets.CustomBusinessHour.nanos 属性よりも柔軟性がありますが、コード量が増えてしまいます。

補足

• ナノ秒単位の精度が必要かどうかを慎重に検討する必要があります。
• 多くの場合、マイクロ秒単位やミリ秒単位の精度で十分です。

• pandas の DateOffset オブジェクト: [無効な URL を削除