Home/ Manual/ time / duration/ Time\Duration::add

Time\Duration::add

PHP function Edit on GitHub ✎

(PHP 8 >= 8.6.0)

Adds a duration

Description

Time\Duration::add(Time\Duration $duration): Time\Duration

Returns the sum of this duration and duration. The signs of both durations are taken into account, so adding a negative duration shortens a positive one.

Parameters

duration: The duration to add.

Return Values

Returns a new Time\Duration object.

Errors/Exceptions

Examples

Time\Duration::add example

php

<?php
$total = \Time\Duration::fromMinutes(1)
    ->add(\Time\Duration::fromSeconds(30))
    ->add(\Time\Duration::fromMilliseconds(500));

var_dump($total);

// Adding a negative duration subtracts it.
$result = \Time\Duration::fromSeconds(10)
    ->add(\Time\Duration::fromSeconds(4)->negate());

var_dump($result->seconds);

The above example will output:

output

object(Time\Duration)#2 (3) {
  ["seconds"]=>
  int(90)
  ["nanoseconds"]=>
  int(500000000)
  ["negative"]=>
  bool(false)
}
int(6)