foundryts.functions.time_extent

foundryts.functions.time_extent()

単一の time series の時間範囲（最も早いタイムスタンプと最も遅いタイムスタンプ）を抽出する関数を返します。

返される関数は、指定された time series の最初から最後のタイムスタンプまでの範囲を特定することで時間範囲を計算します。

返り値: 単一の time series を受け取り、その時間範囲を返す関数。データフレームには時間範囲を含む 1 行が含まれます。
戻り値の型: (FunctionNode) -> SummarizerNode

データフレームスキーマ

列名	型	説明
extent.earliest_timestamp	pandas.Timestamp	シリーズ内の最初のポイントのタイムスタンプ。
extent.latest_timestamp	pandas.Timestamp	シリーズ内の最後のポイントのタイムスタンプ。

例

Copied!1
2
3
4
5
6
7
8
9
10
11
12
>>> series = F.points(
...     (1, 0.0),          # タイムスタンプ1と値0.0のデータポイント
...     (101, 10.2),       # タイムスタンプ101と値10.2のデータポイント
...     (200, 11.3),       # タイムスタンプ200と値11.3のデータポイント
...     (123450, 11.8),    # タイムスタンプ123450と値11.8のデータポイント
... )
>>> series.to_pandas()
                      timestamp  value
0 1970-01-01 00:00:00.000000001    0.0
1 1970-01-01 00:00:00.000000101   10.2
2 1970-01-01 00:00:00.000000200   11.3
3 1970-01-01 00:00:00.000123450   11.8

このコードは、F.points関数を使用してデータポイントのシリーズを作成し、それをPandasのデータフレーム形式に変換しています。タイムスタンプはナノ秒単位で表示され、1970年1月1日からの経過時間を示しています。

Copied!1
2
3
4
5
6
7
>>> time_ext = F.time_extent()(series)
# `time_extent()` は、時系列データの最も早いタイムスタンプと最も遅いタイムスタンプを計算する関数です。
>>> time_ext.to_pandas()
# 結果を pandas データフレーム形式で表示します。
      extent.earliest_timestamp       extent.latest_timestamp
0 1970-01-01 00:00:00.000000001 1970-01-01 00:00:00.000123450
# `extent.earliest_timestamp` は最も早いタイムスタンプを示し、`extent.latest_timestamp` は最も遅いタイムスタンプを示します。