TimeDelta

class astropy.time.TimeDelta(val, val2=None, format=None, scale=None, precision=None, in_subfmt=None, out_subfmt=None, location=None, copy=False)

ベースクラス: astropy.time.core.TimeBase

2つの時間間の時間差を表す.

TimeDeltaオブジェクトは初期化時に1つ以上を持つ val 論争する。時間を入力する val 指定に適合しなければならない format それがそうです。任意選択. val2 時間入力は、非常に高い精度(64ビット精度よりも優れている)を必要とするデジタル入力フォーマット(例えば、JD)にのみ提供されなければならない。

の許容値 format 使用可能：：リスト

>>> list(TimeDelta.FORMATS)
['sec', 'jd', 'datetime']

時間差については、スケールは、重心(‘TAI’，‘TT’，‘TCG’)、重心(‘Tcb’，‘Tdb’)および回転(‘UT 1’)の3つのグループの間であってもよいことに注意されたい。それぞれの場合、時差の目盛りは同じです。地心と重心との間の変換は，スケーリング係数のみが変化するが，“UT 1”に変換できないため，それらの違いだけではなく，実際の時間を知る必要があるからである。似たような理由で、“世界を調整する時”は有効な時差目盛りではありません：世界を調整する時の一日はいつも86400秒ではありません。

また会いましょう

• https://docs.astropy.org/en/stable/time/

• Https：//docs.asterpy.org/en/Stability/time/index.html#time-deltas

パラメータ

val ：Sequence、ndarray、Number、 Quantity あるいは…。 TimeDelta 客体.配列ndarray数字

値は初期化時間差である.任意の数は適切に変換される(従来の時間単位の丸め誤差を避けることに注意)。

val2 ：SEQUENCE、ndarray、Number、または Quantity 選ぶことができる配列、ndarray、数字、または

その他の値は，必要に応じて精度を保つ.

format文字列、オプション

入力値のフォーマット

scale文字列、オプション

入力値の時間スケールは次の値の1つでなければならない：(‘tdb’，‘tt’，‘ut 1’，‘tcg’，‘tcb’，‘tai’).与えられていなければ(または None )であれば、割合は任意である。 Time 例として、変換を行わずに使用される。

copyブル値、オプション

入力値をコピーする

属性要約

FORMATS \	時間増分形式の辞書です。
SCALES \	時間増分スケールのリストです。
T \	データを入れ替えたインスタンスを返す.
cache \	このインスタンスに関連付けられたキャッシュを返す.
format \	タイムフォーマットを取得または設定します。
in_subfmt \	UNIXワイルドカードモードは，文字列入力時間を解析するためのサブフォーマットを選択する.
info \
isscalar \
jd1 \	JD内部には、時間値の2つの倍精度のうちの1つ目が格納される。
jd2 \	JD内部には、時間値の2つ目の倍精度数のうちの2つ目が格納される。
mask \
masked \
ndim \	事例と基底配列の次元数.
out_subfmt \	UNIXワイルドカードモードは，出力時間のためのサブフォーマットを選択する.
precision \	秒時の小数精度(0と9の間(0と9を含む)の整数値を浮動小数点形式で出力する.
scale \	時間尺度.
shape \	時間インスタンスの形状.
size \	対象形状から計算される対象サイズ.
value \	現在のフォーマットの時間値
writeable \

方法要約

argmax \([axis, out] )	与えられた軸に沿って最大値のインデックスを返す.
argmin \([axis, out] )	与えられた軸に沿って最小値のインデックスを返す.
argsort \([axis] )	時間配列をソートするインデックスを返す.
copy \([format] )	完全に独立したTimeオブジェクトコピーを返し、フォーマット変更を選択することができます。
diagonal \(*args, * *kwargs)	指定された対角線を持つインスタンスを返す.
flatten \(*args, * *kwargs)	1次元に折り畳まれた配列を含むコピーを返す.
insert \(OBJ，値[, axis] )	列中の所与のインデックスの前に値を挿入し、新しいものを返す Time あるいは…。 TimeDelta 物体です。
isclose \(その他[, atol, rtol] )	ブール型またはブール型配列に戻り，そのうちの2つのTimeDeltaオブジェクトは時間許容差内の要素で等しい.
max \([axis, out, keepdims] )	与えられた軸に沿った最大値。
min \([axis, out, keepdims] )	与えられた軸に沿った最小値。
ptp \([axis, out, keepdims] )	与えられた軸に沿ったピーク間(最大−最小)。
ravel \(*args, * *kwargs)	1つの配列が1次元に折り畳まれた例を返す.
replicate \(*args, * *kwargs)	時間オブジェクトのコピーを返し、フォーマット変更を選択することができます。
reshape \(*args, * *kwargs)	新しい形状を持つ同じデータを含むインスタンスを返す.
sort \([axis] )	指定された軸に沿ってソートされたコピーを返します。
squeeze \(*args, * *kwargs)	1次元形状エントリを削除した例を返す
swapaxes \(*args, * *kwargs)	与えられた軸を交換した例を返す.
take \(索引)[, axis, out, mode] )	所与のインデックスにおける要素からなる新しいインスタンスを返す。
to \(単位[, equivalencies] )	指定された単位で表される数に変換する.
to_datetime \()	変換して datetime.timedelta 物体です。
to_value \(*args, * *kwargs)	指定された出力フォーマットまたは単位で表される時間増分値を取得する。
transpose \(*args, * *kwargs)	データを入れ替えたインスタンスを返す.

属性文書

FORMATS = {'datetime': <class 'astropy.time.formats.TimeDeltaDatetime'>, 'jd': <class 'astropy.time.formats.TimeDeltaJD'>, 'sec': <class 'astropy.time.formats.TimeDeltaSec'>}

時間増分形式の辞書です。

SCALES = ('tai', 'tt', 'tcg', 'tcb', 'tdb', 'ut1', 'local')

時間増分スケールのリストです。

T

データを入れ替えたインスタンスを返す.

パラメータと T それがそうです。すべての内部データはオリジナルデータのビューである.

cache

このインスタンスに関連付けられたキャッシュを返す.

format

タイムフォーマットを取得または設定します。

このフォーマットは通過を定義しています .value 属性です。デフォルトでは、初期化のための Time 一例であるが、初期化のために使用可能な任意の他の値に設定されてもよい。これらのリストは以下のように使用することができる：

>>> list(Time.FORMATS)
['jd', 'mjd', 'decimalyear', 'unix', 'unix_tai', 'cxcsec', 'gps', 'plot_date',
 'stardate', 'datetime', 'ymdhms', 'iso', 'isot', 'yday', 'datetime64',
 'fits', 'byear', 'jyear', 'byear_str', 'jyear_str']

in_subfmt

UNIXワイルドカードモードは，文字列入力時間を解析するためのサブフォーマットを選択する.

info

isscalar

jd1

JD内部には、時間値の2つの倍精度のうちの1つ目が格納される。

jd2

JD内部には、時間値の2つ目の倍精度数のうちの2つ目が格納される。

mask

masked

ndim

事例と基底配列の次元数.

out_subfmt

UNIXワイルドカードモードは，出力時間のためのサブフォーマットを選択する.

precision

秒時の小数精度(0と9の間(0と9を含む)の整数値を浮動小数点形式で出力する.

scale

時間尺度.

shape

時間インスタンスの形状.

像 shape タプルを割り当てることによって新しい形状に設定することができる。異なるインスタンスが部分を共有するが、全ての基礎データではない場合、1つのインスタンスの形状を設定することは、別のインスタンスを利用できない可能性があることに留意されたい。そのため、使用を強く推奨しています reshape 方法です。

賃上げをする

ValueError

もし新しい形状の要素の総数が間違っていたら。

AttributeError

If the shape of the jd1, jd2, location, delta_ut1_utc, or delta_tdb_tt attributes cannot be changed without the arrays being copied. For these cases, use the Time.reshape method (which copies any arrays that cannot be reshaped in-place).

size

対象形状から計算される対象サイズ.

value

現在のフォーマットの時間値

writeable

方法文書

argmax(axis=None, out=None)

与えられた軸に沿って最大値のインデックスを返す.

これは似たようなものです argmax() ただし，2つの倍精度値が与える完全な精度を確保するように調整した jd1 そして jd2 使っています。参照してください argmax() 詳細文書については、参照されたい。

argmin(axis=None, out=None)

与えられた軸に沿って最小値のインデックスを返す.

これは似たようなものです argmin() ただし，2つの倍精度値が与える完全な精度を確保するように調整した jd1 そして jd2 使っています。参照してください argmin() 詳細文書については、参照されたい。

argsort(axis=- 1)

時間配列をソートするインデックスを返す.

これは似たようなものです argsort() ただし，2つの倍精度値が与える完全な精度を確保するように調整した jd1 そして jd2 対応する属性をコピーします内部では lexsort() そのため，ランキング方法を選択することはできない.

copy(format=None)

完全に独立したTimeオブジェクトコピーを返し、フォーマット変更を選択することができます。

もし format これに応じて、戻る時間オブジェクトの時間フォーマットが設定され、そうでなければ、元の時間オブジェクトと変わらないままになる。

この方法では，内部時間配列の完全コピーを作成する.ユーザは通常内部時間配列を変更することができないため，多くの場合 replicate() 使い方をすべきです。

パラメータ

format文字列、オプション

コピーのタイムフォーマットです。

返品

tm時間対象

この対象のコピー

diagonal(*args, **kwargs)

指定された対角線を持つインスタンスを返す.

パラメータと diagonal() それがそうです。すべての内部データはオリジナルデータのビューである.

flatten(*args, **kwargs)

1次元に折り畳まれた配列を含むコピーを返す.

パラメータと flatten() それがそうです。

insert(obj, values, axis=0)

列中の所与のインデックスの前に値を挿入し、新しいものを返す Time あるいは…。 TimeDelta 物体です。

挿入する値は該当する定位置設定規則に適合しなければならない Time 対象(参照) Get and set values はい。 Time 文書)。

API署名と np.insert APIは、しかし、より多くの制限を受けている。INSERTインデックス仕様 obj 単一の整数でなければなりません axis きっとそうだ 0 インデックスの前に簡単な行を挿入するために用いられる.

パラメータ

obj集積する.

その前の整数インデックス values 挿入されています。

valuesアレイ式.

挿入する値です。もしタイプが values 数とは違います values マッチングタイプに変換します。

axis形が整っていて、オプションです

挿入された軸に沿って values それがそうです。デフォルト値は0であり、これは唯一の許容値であり、1行に挿入される。

返品

out ： Time 子類.時間類.

挿入値を持つ新しい時間オブジェクト

isclose(other, atol=None, rtol=0.0)

ブール型またはブール型配列に戻り，そのうちの2つのTimeDeltaオブジェクトは時間許容差内の要素で等しい.

これは、以下の式を効率的に計算する。

abs(self - other) <= atol + rtol * abs(other)

パラメータ

他にも ： Quantity あるいは…。 TimeDelta数量や時間の増加

比較に用いたQuantityやTimeDeltaオブジェクト.

atol ： Quantity あるいは…。 TimeDelta数量や時間の増加

時間単位に等しい絶対公差(例えば u.s あるいは…。 u.day )である。デフォルト値は128ビットJD時間表示の1ビットであり，約20ピコ秒に相当する.

rtol浮いている.

平等に対する相対容認

max(axis=None, out=None, keepdims=False)

与えられた軸に沿った最大値。

これは似たようなものです max() ただし，2つの倍精度値が与える完全な精度を確保するように調整した jd1 そして jd2 対応する属性をコピーします

注意してください。 out パラメータの存在は互換性のためだけです np.max なぜなら Time 実例は不変であるので，実際的なものはあり得ない out その結果を格納する.

min(axis=None, out=None, keepdims=False)

与えられた軸に沿った最小値。

これは似たようなものです min() ただし，2つの倍精度値が与える完全な精度を確保するように調整した jd1 そして jd2 対応する属性をコピーします

注意してください。 out パラメータの存在は互換性のためだけです np.min なぜなら Time 実例は不変であるので，実際的なものはあり得ない out その結果を格納する.

ptp(axis=None, out=None, keepdims=False)

与えられた軸に沿ったピーク間(最大−最小)。

これは似たようなものです ptp() ただし，2つの倍精度値が与える完全な精度を確保するように調整した jd1 そして jd2 全部使っています。

注意してください。 out パラメータの存在は互換性のためだけです ptp なぜなら Time 実例は不変であるので，実際的なものはあり得ない out その結果を格納する.

ravel(*args, **kwargs)

1つの配列が1次元に折り畳まれた例を返す.

パラメータと ravel() それがそうです。データを複製せずに配列を解くことができるわけではないことに注意されたい.データを複製する際にエラーを起こしたい場合は，形状を指定すべきである. (-1,) Shape属性に追加します。

replicate(*args, **kwargs)

時間オブジェクトのコピーを返し、フォーマット変更を選択することができます。

もし format これに応じて、戻る時間オブジェクトの時間フォーマットが設定され、そうでなければ、元の時間オブジェクトと変わらないままになる。

もし copy とする. True そして，内部時間配列の完全コピーを作成する.デフォルトの場合、コピーサーバは、メモリを節約するために、可能な場合に元のアレイへの参照を使用するであろう。ユーザは通常内部時間配列を変更することができないため，多くの場合設定する必要がない. copy 至る True それがそうです。

便利な方法copy()が使えます、その中に copy はい。 True デフォルトの場合。

パラメータ

format文字列、オプション

コピーのタイムフォーマットをコピーします。

copyブル値、オプション

可能な場合、参照を使用するのではなく、真のコピーが返される。

返品

tm時間対象

この対象のコピー

reshape(*args, **kwargs)

新しい形状を持つ同じデータを含むインスタンスを返す.

パラメータと reshape() それがそうです。データをコピーすることなく配列の形状を常に変更できるわけではないことに注意されたい(参照 reshape() 文書)。データを複製する際に誤りを起こしたい場合には，新しい形状をShape属性に割り当てるべきである(これはすべての使用には適用できない可能性があることに注意). NDArrayShapeMethods ）。

sort(axis=- 1)

指定された軸に沿ってソートされたコピーを返します。

これは似たようなものです sort() ただし，内部ではインデックスを用いる lexsort() 2つの倍精度で与えられた完全な精度を確保する jd1 そして jd2 また、対応する属性も適切に順序付けされて複製される。

パラメータ

axis形がそろっているかないか

順番をつける軸。もし…。 None 次に，展開された配列をソートする.デフォルトの場合は，最後の軸でソートする.

squeeze(*args, **kwargs)

1次元形状エントリを削除した例を返す

パラメータと squeeze() それがそうです。すべての内部データはオリジナルデータのビューである.

swapaxes(*args, **kwargs)

与えられた軸を交換した例を返す.

パラメータと swapaxes() ： axis1, axis2 それがそうです。すべての内部データはオリジナルデータのビューである.

take(indices, axis=None, out=None, mode='raise')

所与のインデックスにおける要素からなる新しいインスタンスを返す。

パラメータと take() しかし，明らかに出力配列を与えることはできない.

to(unit, equivalencies=[])

指定された単位で表される数に変換する.

パラメータ

unit単式式

変換する単位です。

equivalenciesメタグループリスト

単位が直接変換できない場合に試みる等価ペアリスト(参照 等価物. )である。もし…。 None したがって、等価物は全く適用されず、グローバルまたはコンテキストにおいていかなるセットも適用されない。

返品

量 ： Quantity量

指定された単位で表される数。

参考

to_value

与えられた単位の値を取得する.

to_datetime()

変換して datetime.timedelta 物体です。

to_value(*args, **kwargs)

指定された出力フォーマットまたは単位で表される時間増分値を取得する。

この方法は非常に柔軟であり，指定されたものに同時に扱うことができる. TimeDelta /サブフォーマットして指定された単位に変換します。位置パラメータが提供された場合、第1のパラメータが有効であるかどうかをチェックする TimeDelta フォーマットは、その後、有効な単位または単位文字列であるかどうかをチェックします。

変換するには TimeDelta フォーマットおよびオプションのサブフォーマットオプションは、：

tm = TimeDelta(1.0 * u.s)
tm.to_value('jd')  # equivalent of tm.jd
tm.to_value('jd', 'decimal')  # convert to 'jd' as a Decimal object
tm.to_value('jd', subfmt='decimal')
tm.to_value(format='jd', subfmt='decimal')

オプションの等価値を有する単位に変換するには、：

tm.to_value('hr')  # convert to u.hr (hours)
tm.to_value('hr', [])  # specify equivalencies as a positional arg
tm.to_value('hr', equivalencies=[])
tm.to_value(unit='hr', equivalencies=[])

The built-in TimeDelta options for format are: {'jd', 'sec', 'datetime'}.

2つのデジタルフォーマット‘jd’および‘sec’の場合、利用可能である。 subfmt オプションは{‘浮動小数点’，‘長’，‘小数’，‘文字列’，‘バイト’}である.ここで“long”の使い方は numpy.longdouble ある程度精度を向上させるために(増強度はプラットフォームに依存する)、 decimal.Decimal 完全な精度を達成するために。‘str’および‘bytes’サブフォーマットについても、時間値を正確に表すために数字の数が選択される。デフォルト値：以下の人員で設定する out_subfmt (デフォルトの場合、所与のフォーマットのために最初に利用可能なフォーマット、すなわち“Float”)を選択します。

パラメータ

format文字列、オプション

一人で欲しい書式 TimeDelta 価値観。デフォルト値：現在のフォーマット。

subfmt文字列、オプション

可能なサブフォーマットは、値が与えられるべきである。デフォルト値：以下の人員で設定する out_subfmt (デフォルトの場合、所与のフォーマットのために最初に利用可能なフォーマット、すなわち“FLOAT”または‘DATE_HMS’)を選択します)。

unit ： UnitBase インスタンスまたは文字列、オプションUnitBaseインスタンスまたは文字列、オプション

一定の値を与えるべき単位。

equivalenciesメタグループリスト

単位が直接変換できない場合に試みる等価ペアリスト(参照 等価物. )である。もし…。 None 等価物は全く適用されず、全体的にもコンテキストでもいかなるセットも適用されない。

返品

valueNdarrayまたはスカラー

指定されたフォーマットまたは単位で表される値。

参考

to

変換して Quantity 実例です。

value

現在のフォーマットの時間値。

transpose(*args, **kwargs)

データを入れ替えたインスタンスを返す.

パラメータと transpose() それがそうです。すべての内部データはオリジナルデータのビューである.