(PHP 5 >= 5.3.0)
DateInterval::__construct — Crea un nuevo objeto DateInterval
$interval_spec
)Crea un nuevo objeto DateInterval.
interval_specUna especificación de intervalo.
El formato empieza con la letra P, de "periodo." Cada periodo de duración está representado por un valor integer seguido de un indicador de periodo. Si la duración contiene elementos de hora, esta parte de la especificación está precedida por una letra T.
| Indicador de periodo | Descripción |
|---|---|
| Y | años |
| M | meses |
| D | días |
| W | semanas. Éstas se convierten a días, por lo que no se puede combinar con D. |
| H | horas |
| M | minutos |
| S | segundos |
Aquí hay 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 como P4D1Y.
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 vuelta 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 Exception cuando el interval_spec
no puede ser analizado como un intervalo.
Ejemplo #1 Ejemplo de DateInterval
<?php
$intervalo = new DateInterval('P2Y4DT6H8M');
var_dump($intervalo);
?>
El resultado del ejemplo sería:
object(DateInterval)#1 (8) {
["y"]=>
int(2)
["m"]=>
int(0)
["d"]=>
int(4)
["h"]=>
int(6)
["i"]=>
int(8)
["s"]=>
int(0)
["invert"]=>
int(0)
["days"]=>
bool(false)
}