(PHP 5 >= 5.3.0, PHP 7, PHP 8)
DateInterval::__construct — Crea un nuevo objeto DateInterval
duration
Una especificación de intervalo.
El formato empieza con la letra P
,
de periodo.
Cada periodo de duración está representado por un valor de tipo integer
seguido de un indicador de periodo.
Si la duración contiene elementos de hora, esa parte
de la especificación estará precedida por una letra
T
.
Indicador de periodo | Descripción |
---|---|
Y |
años |
M |
meses |
D |
días |
W |
semanas; estas se convierten a días,
Antes de PHP 8.0.0, no se puede combinar con D .
|
H |
horas |
M |
minutos |
S |
segundos |
Algunos ejemplos sencillos:
Dos días es P2D
.
Dos segundos es PT2S
.
Seis años y cinco minutos es P6YT5M
.
Nota:
Los tipos de unidades deben ser escritos desde la unidad de escala más grande a la izquierda a la unidad de escala más pequeña a la derecha. Así los años van antes que los meses, meses antes que días, días antes que minutos, etc. Así un año y cuatro días debe representarse como
P1Y4D
, y no comoP4D1Y
.
La especificación también puede ser representada como una fecha/hora.
Un ejemplo de un año y cuatro días sería
P0001-00-04T00:00:00
.
Pero los valores en este formato no pueden exceder el punto de desbordamiento
de un periodo (p.ej. 25
horas no es válido).
Estos formatos están basados en la » especificación de duración ISO 8601.
Lanza una DateMalformedIntervalStringException cuando
el duration
no puede ser analizado como un intervalo.
Antes de PHP 8.3, esto era Exception.
Versión | Descripción |
---|---|
8.3.0 | Ahora lanza DateMalformedIntervalStringException en lugar de Exception. |
8.2.0 |
Solo serán visibles las propiedades y a f ,
invert y days , incluyendo una nueva
propiedad booleana from_string .
|
8.0.0 |
W se puede combinar con D .
|
Ejemplo #1 Contruyendo y usando objetos DateInterval
<?php
// Crea una fecha especifica
$someDate = \DateTime::createFromFormat("Y-m-d H:i", "2022-08-25 14:18");
// Crea un intervalo
$interval = new \DateInterval("P7D");
// Añade el intervalo
$someDate->add($interval);
// Convierte el intervalo a string
echo $interval->format("%d");
El resultado del ejemplo sería:
7
Ejemplo #2 Ejemplo de DateInterval
<?php
$interval = new DateInterval('P1W2D');
var_dump($interval);
?>
Salida del ejemplo anterior en PHP 8.2:
object(DateInterval)#1 (10) { ["y"]=> int(0) ["m"]=> int(0) ["d"]=> int(9) ["h"]=> int(0) ["i"]=> int(0) ["s"]=> int(0) ["f"]=> float(0) ["invert"]=> int(0) ["days"]=> bool(false) ["from_string"]=> bool(false) }
Salida del ejemplo anterior en PHP 8:
object(DateInterval)#1 (16) { ["y"]=> int(0) ["m"]=> int(0) ["d"]=> int(9) ["h"]=> int(0) ["i"]=> int(0) ["s"]=> int(0) ["f"]=> float(0) ["weekday"]=> int(0) ["weekday_behavior"]=> int(0) ["first_last_day_of"]=> int(0) ["invert"]=> int(0) ["days"]=> bool(false) ["special_type"]=> int(0) ["special_amount"]=> int(0) ["have_weekday_relative"]=> int(0) ["have_special_relative"]=> int(0) }
Salida del ejemplo anterior en PHP 7:
object(DateInterval)#1 (16) { ["y"]=> int(0) ["m"]=> int(0) ["d"]=> int(2) ["h"]=> int(0) ["i"]=> int(0) ["s"]=> int(0) ["f"]=> float(0) ["weekday"]=> int(0) ["weekday_behavior"]=> int(0) ["first_last_day_of"]=> int(0) ["invert"]=> int(0) ["days"]=> bool(false) ["special_type"]=> int(0) ["special_amount"]=> int(0) ["have_weekday_relative"]=> int(0) ["have_special_relative"]=> int(0) }