foundryts.functions.time_shift

foundryts.functions.time_shift(duration)

指定された期間だけ単一の time series のすべてのタイムスタンプを前後にシフトする関数を返します。

ポイント (timestamp, value) を持つソース time series を duration でシフトすると、結果の時間がシフトされた time series はポイント (timestamp + duration, value) を持ちます。正の duration のシフト値はタイムスタンプを未来に進め、負の duration の値はタイムスタンプを過去に戻します。

• パラメーター: duration (int , datetime.timedelta , str) – タイムスタンプを前後にシフトする時間の量を整数、datetime.timedelta オブジェクト、または文字列として指定します。整数はナノ秒の数として解釈されます。より人間が読みやすい期間については、datetime.timedelta オブジェクトや pandas.Timedelta として解析される文字列を指定できます。文字列入力は pandas.to_timedelta で認識される形式に従う必要があります。たとえば、‘1 day’、‘1 hour’、‘10 minutes’、または ’42s’ などです。
• 戻り値: 単一の time series を入力として受け取り、時間がシフトされた time series を返す関数。
• 戻り値の型: (FunctionNode) -> FunctionNode

データフレームスキーマ

例

Copied!
1
2
3
4
5
6
7
>>> time_shifted = F.time_shift(1000)(series)
>>> time_shifted.to_pandas()
                      timestamp    value
0 1970-01-01 00:00:00.000001100  0.00000
1 1970-01-01 00:00:00.000001200      inf
2 1970-01-01 00:00:00.000001300  3.14159
3 1970-01-01 00:00:02.147484647  1.00000

このコードは、F.time_shift(1000)関数を使用して、時系列データseriesを1,000ユニットだけ時間シフトさせた後に、Pandasデータフレーム形式に変換しています。timestamp列はシフト後の時間を示し、value列は対応する値を保持しています。