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