Documentación offline PHP master

DateTime::sub

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

DateTime::sub

date_sub

Sustrae una cantidad de días, meses, años, horas, minutos y segundos de un objeto DateTime

Descripción#

Estilo orientado a objetos

public DateTime::sub(DateInterval $interval): DateTime
```php

Estilo procedimental

```php
date_sub(DateTime $object, DateInterval $interval): DateTime

Modifica el objeto DateTime especificado, sustrayendo el objeto DateInterval especificado.

Igual que DateTimeImmutable::sub pero funciona con DateTime.

La versión procedural toma el objeto DateTime como su primer argumento.

Parámetros#

object
Solo en estilo procedimental: Un objeto DateTime retornado por la función date_create. Esta función modifica este objeto.

interval
Un objeto DateInterval

Valores devueltos#

Retorna el objeto modificado DateTime para encadenar métodos.

Errores/Excepciones#

Solo en la API Orientada a Objetos: Si se intenta realizar una operación no soportada, como usar un objeto DateInterval que represente especificaciones de tiempo relativas como próximo día de la semana, se lanzará una DateInvalidOperationException.

Historial de cambios#

Versión Descripción
8.3.0 Ahora lanza una DateInvalidOperationException con DateTime::sub, en lugar de una advertencia cuando se intenta realizar una operación no soportada. La función date_sub no ha cambiado.

Véase también#

DateTimeImmutable::sub