Time\Duration::fromNanoseconds

ナノ秒数から期間を作成する

説明

public static Time\Duration Time\Duration::fromNanoseconds(int $nanoseconds)

nanoseconds ナノ秒の、負でない期間を作成します。 値は整数の秒数とナノ秒数に正規化されます。 Time\Duration::$seconds と Time\Duration::$nanoseconds プロパティを参照ください。

パラメータ

nanoseconds
ナノ秒数。 0 以上でなければなりません。

戻り値

新しい Time\Duration オブジェクトを返します。

エラー / 例外

  • nanoseconds が負の場合、 ValueError がスローされます。

例

例1 Time\Duration::fromNanoseconds の例

<?php
var_dump(\Time\Duration::fromNanoseconds(1_500_000_000));

上の例の出力は以下となります。

object(Time\Duration)#1 (3) {
  ["seconds"]=>
  int(1)
  ["nanoseconds"]=>
  int(500000000)
  ["negative"]=>
  bool(false)
}

例2 hrtime で経過時間を計測する

<?php
$start = hrtime(true);
usleep(1000);
$elapsed = \Time\Duration::fromNanoseconds(hrtime(true) - $start);

var_dump($elapsed);

上の例の出力は、 たとえば以下のようになります。

object(Time\Duration)#1 (3) {
  ["seconds"]=>
  int(0)
  ["nanoseconds"]=>
  int(1062541)
  ["negative"]=>
  bool(false)
}

参考

  • Time\Duration::fromSeconds
  • Time\Duration::fromMicroseconds
  • Time\Duration::fromMilliseconds
  • hrtime