Oihana PHP

subSeconds.php

Table of Contents

Functions

subSeconds()  : DateTimeImmutable
Returns a copy of a date shifted backwards by a number of seconds.

Functions

subSeconds()

Returns a copy of a date shifted backwards by a number of seconds.

subSeconds(DateTimeInterface $date, int $seconds) : DateTimeImmutable

A new DateTimeImmutable is returned ; the source date is never modified. Equivalent to addSeconds( $date , -$seconds ) — see addSeconds() for the elapsed-time semantics across a DST transition.

Parameters
$date : DateTimeInterface

The source date.

$seconds : int

The number of seconds to subtract.

Tags
throws
DateMalformedStringException

Never thrown in practice (the modifier is always well-formed).

example
use function oihana\core\date\subSeconds;

subSeconds( new DateTimeImmutable( '2026-01-01 00:01:30' ) , 90 ) ; // 2026-01-01 00:00:00
author

Marc Alcaraz (ekameleon)

since
1.2.0
Return values
DateTimeImmutable

A new immutable date shifted backwards by $seconds seconds.

On this page

Search results