Time\Duration::fromSeconds

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

説明

public static Time\Duration Time\Duration::fromSeconds(int $seconds, int $nanoseconds = 0)

seconds 秒に nanoseconds ナノ秒を足した、負でない期間を作成します。

パラメータ

seconds
整数の秒数。 0 以上でなければなりません。
nanoseconds
1 秒未満の端数 (ナノ秒単位)。 0 以上 999999999 以下でなければなりません。

戻り値

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

エラー / 例外

  • seconds が負の場合、 ValueError がスローされます。
  • nanoseconds が負の場合、 ValueError がスローされます。
  • nanoseconds が 1000000000 以上の場合、 ValueError がスローされます。
  • 結果が 期間の最大長 を超える場合、Time\TimeException がスローされます。

例

例1 Time\Duration::fromSeconds の例

<?php
var_dump(\Time\Duration::fromSeconds(90));
var_dump(\Time\Duration::fromSeconds(1, 500_000_000));

try {
    \Time\Duration::fromSeconds(0, 1_000_000_000);
} catch (ValueError $e) {
    echo $e->getMessage(), PHP_EOL;
}

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

object(Time\Duration)#1 (3) {
  ["seconds"]=>
  int(90)
  ["nanoseconds"]=>
  int(0)
  ["negative"]=>
  bool(false)
}
object(Time\Duration)#2 (3) {
  ["seconds"]=>
  int(1)
  ["nanoseconds"]=>
  int(500000000)
  ["negative"]=>
  bool(false)
}
Time\Duration::fromSeconds(): Argument #2 ($nanoseconds) must be less than 1_000_000_000

参考

  • Time\Duration::fromNanoseconds
  • Time\Duration::fromMicroseconds
  • Time\Duration::fromMilliseconds
  • Time\Duration::fromMinutes
  • Time\Duration::fromHours
  • Time\Duration::fromIso8601DurationString