Time\Duration::sub

(PHP 8 >= 8.6.0)

Time\Duration::sub — Soustrait une durée

Description

public function Time\Duration::sub(Time\Duration $duration): Time\Duration

Retourne la différence entre cette durée et duration. Le signe des deux durées est pris en compte : soustraire une durée négative allonge donc une durée positive. Si duration est plus longue que cette durée, le résultat est négatif.

Liste de paramètres

duration: La durée à soustraire.

Valeurs de retour

Retourne un nouvel objet Time\Duration.

Erreurs / Exceptions

Si la durée résultante dépasse la longueur maximale d'une durée, une Time\TimeException est lancée.

Exemples

Exemple #1 Exemple avec Time\Duration::sub()

<?php
var_dump(\Time\Duration::fromSeconds(10)->sub(\Time\Duration::fromMilliseconds(2500)));

// Soustraire une durée plus grande donne une durée négative.
var_dump(\Time\Duration::fromSeconds(1)->sub(\Time\Duration::fromSeconds(3)));

L'exemple ci-dessus va afficher :

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

Voir aussi

Time\Duration::add() - Ajoute une durée
Time\Duration::negate() - Retourne la durée avec le signe opposé
Time\Duration::absolute() - Retourne la valeur absolue de la durée

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes

There are no user contributed notes for this page.