PHP 8.6.0 Beta 3 is available for testing

    La classe DateInterval

    (PHP 5 >= 5.3.0, PHP 7, PHP 8)

    Introduction

    Représente un intervalle de dates.

    Un intervalle stocke un nombre fixe de durées (en années, mois, jours, heures, etc.) ou une chaîne relative à une durée dans un format compréhensible par le constructeur de la classe DateTime et DateTimeImmutable.

    Plus précisément, l'information d'un objet de la classe DateInterval est une instruction pour aller d'une date/moment à une autre date/moment. Ce processus n'est pas toujours réversible.

    Une façon typique de créer un objet DateInterval est en calculant la différence entre deux objets dates/moments à travers DateTimeInterface::diff().

    La façon dont la partie horaire d'un intervalle, c'est-à-dire les heures, les minutes, les secondes et les microsecondes, est appliquée lorsque l'intervalle est ajouté à un objet date/heure, ou soustrait de celui-ci, dépend de la manière dont l'intervalle a été créé. Pour un intervalle créé avec DateInterval::__construct(), la partie horaire correspond au temps écoulé, tandis que pour un intervalle créé avec DateInterval::createFromDateString(), ou retourné par DateTimeInterface::diff(), elle incrémente ou décrémente les valeurs individuelles des composants. La partie date, c'est-à-dire les années, les mois et les jours, incrémente ou décrémente toujours les valeurs individuelles des composants. Les deux ne donnent donc un résultat différent que lorsqu'une transition de fuseau horaire tombe dans la partie horaire de l'intervalle ; voir Arithmétique avec DateTime.

    Comme il n'y a pas une manière bien définie pour comparer les intervalles, les instances de DateInterval sont incomparables.

    Synopsis de la classe

    class DateInterval {
    /* Propriétés */
    public int $y;
    public int $m;
    public int $d;
    public int $h;
    public int $i;
    public int $s;
    public float $f;
    public int $invert;
    public mixed $days;
    public bool $from_string;
    public string $date_string;
    /* Méthodes */
    public function __construct(string $duration)
    public static function createFromDateString(string $datetime): DateInterval
    public function format(string $format): string
    }

    Propriétés

    Avertissement

    Les propriétés disponibles répertoriées ci-dessous dépendent de la version de PHP et doivent être considérées en lecture seule.

    y

    Nombre d'années.

    m

    Nombre de mois.

    d

    Nombre de jours.

    h

    Nombre d'heures.

    i

    Nombre de minutes.

    s

    Nombre de secondes.

    f

    Nombre de microsecondes, en une fraction de seconde.

    invert

    Vaut 1 si l'intervalle représente une période de temps négative, 0 sinon. Voir la méthode DateInterval::format().

    days

    Si l'objet DateInterval a été créé avec la méthode DateTimeImmutable::diff() ou DateTime::diff(), alors ce sera le nombre total de jours entre la date de début et la date de fin. Sinon, days vaudra false.

    from_string

    Si l'objet DateInterval a été créé avec la méthode DateInterval::createFromDateString(), alors cette propriété vaudra true, et la propriété date_string sera renseignée. Sinon, cette propriété vaudra false, et les propriétés de y à f, invert, et days seront renseignées.

    date_string

    La chaîne de caractères utilisée comme argument pour DateInterval::createFromDateString().

    Historique

    Version Description
    8.2.0 Les propriétés from_string et date_string ont été ajoutées aux instances de DateInterval qui ont été créées à l'aide de la méthode DateInterval::createFromDateString().
    8.2.0 Seules les propriétés de y jusqu'à f, invert, et days seront visibles.
    7.4.0 Les instances de DateInterval sont désormais incomparables ; auparavant, toutes les instances DateInterval étaient considérées comme égales.
    7.1.0 La propriété f a été ajoutée.

    Sommaire

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 2 notes

    up
    64
    cb
    3 years ago
    If you want to reverse a date interval use array_reverse and iterator_to_array. I've found using invert to be unreliable.

<?php
$start_date = date_create("2021-01-01");
$end_date   = date_create("2021-01-05"); // If you want to include this date, add 1 day

$interval = DateInterval::createFromDateString('1 day');
$daterange = new DatePeriod($start_date, $interval ,$end_date);

function show_dates ($dr) {
    foreach($dr as $date1){
        echo $date1->format('Y-m-d').'<br>';
    }
}
 
show_dates ($daterange);
   
echo '<br>';

// reverse the array

$daterange = array_reverse(iterator_to_array($daterange));

show_dates ($daterange);
           
?>

Gives 
 2021-01-01
 2021-01-02
 2021-01-03
 2021-01-04

 2021-01-04
 2021-01-03
 2021-01-02
 2021-01-01
    up
    1
    julio dot necronomicon at gmail dot com
    2 years ago
    More simple example i use to add or subtract.

<?php
$Datetime = new Datetime('NOW', new DateTimeZone('America/Bahia'));
$Datetime->add(DateInterval::createFromDateString('2 day'));

echo $Datetime->format("Y-m-d H:i:s");
?>
    ＋add a note
    To Top