DateInterval::__construct

(PHP 5 >= 5.3.0)

DateInterval::__construct — Crea un nuevo objeto DateInterval

Descripción

public DateInterval::__construct() ( string $interval_spec )

Crea un nuevo objeto DateInterval.

Parámetros

interval_spec

Especificación del 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.

Indicadores de Periodo de *`interval_spec`*
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.

Note:
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.

Ejemplos

Example #1 Ejemplo de DateInterval


<?php

$intervalo = new DateInterval('P2Y4DT6H8M');
print_r($intervalo);

?>

El resultado del ejemplo sería:

DateInterval Object
(
    [y] => 2
    [m] => 0
    [d] => 4
    [h] => 6
    [i] => 8
    [s] => 0
    [invert] => 0
    [days] => 0
)

Ver también

DateInterval::format() - Formatea el intervalo
DateTime::add() - Añade una cantidad de días, meses, años, horas, minutos y segundos al objeto DateTime
DateTime::sub() - Sustrae una cantidad de días, meses, años, horas, minutos y segundos de un objeto DateTime
DateTime::diff() - Devuelve la diferencia entres objetos DateTime

add a note User Contributed Notes DateInterval::__construct

kevinpeno at gmail dot com 17-Mar-2011 07:47


Note that, while a DateInterval object has an $invert property, you cannot supply a negative directly to the constructor similar to specifying a negative in XSD ("-P1Y"). You will get an exception through if you do this. 



Instead you need to construct using a positive interval ("P1Y") and the specify the $invert property === 1.

kuzb 05-Feb-2011 12:42


It should be noted that this class will not calculate days/hours/minutes/seconds etc given a value in a single denomination of time.  For example:



<?php

    $di = new DateInterval('PT3600S');

    echo $di->format('%H:%i:%s');

    

?>



will yield 0:0:3600 instead of the expected 1:0:0

add a note