Time\Duration::negate

符号を反転した期間を返す

説明

public Time\Duration Time\Duration::negate()

長さが同じで、符号を反転した期間を返します。 正の期間は負に、負の期間は正になります。 長さ 0 の期間は、符号を反転しても長さ 0 のままで、負になることはありません。

パラメータ

この関数にはパラメータはありません。

戻り値

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

例

例1 Time\Duration::negate の例

<?php
$duration = \Time\Duration::fromSeconds(30);

var_dump($duration->negate()->negative);
var_dump($duration->negate()->negate()->negative);

// 長さ 0 の期間には符号がありません。
var_dump(\Time\Duration::fromSeconds(0)->negate()->negative);

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

bool(true)
bool(false)
bool(false)

参考

  • Time\Duration::absolute
  • Time\Duration::sub