Time\Duration::fromHours

時間数から期間を作成する

説明

public static Time\Duration Time\Duration::fromHours(int $hours)

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

パラメータ

hours
時間数。 0 以上でなければなりません。

戻り値

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

エラー / 例外

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

例

例1 Time\Duration::fromHours の例

<?php
var_dump(\Time\Duration::fromHours(24));

try {
    \Time\Duration::fromHours(PHP_INT_MAX);
} catch (\Time\TimeException $e) {
    echo $e->getMessage(), PHP_EOL;
}

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

object(Time\Duration)#1 (3) {
  ["seconds"]=>
  int(86400)
  ["nanoseconds"]=>
  int(0)
  ["negative"]=>
  bool(false)
}
The maximum representable range is 9_223_372_035 seconds (roughly 292 years)

参考

  • Time\Duration::fromSeconds
  • Time\Duration::fromMinutes
  • Time\Duration::fromIso8601DurationString