PHP.mk документација

DatePeriod

Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.

class.dateperiod.php PHP.net прокси Преводот се освежува
Оригинал на PHP.net
Патека class.dateperiod.php Локална патека за оваа страница.
Извор php.net/manual/en Оригиналниот HTML се реупотребува и локално се стилизира.
Режим Прокси + превод во позадина Кодовите, табелите и белешките остануваат читливи во истиот тек.
DatePeriod

Референца за `class.dateperiod.php` со подобрена типографија и навигација.

class.dateperiod.php

Класата DatePeriod

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

Вовед

Претставува временски период.

Временскиот период овозможува итерација над множество датуми и времиња, кои се повторуваат во правилни интервали, во текот на даден период.

Синопсис на класата

class DatePeriod implements IteratorAggregate {
/* Константи */
public const int EXCLUDE_START_DATE;
public const int INCLUDE_END_DATE;
/* Својства */
public readonly ?DateTimeInterface $start;
public readonly ?DateTimeInterface $current;
public readonly ?DateTimeInterface $end;
public readonly ?DateInterval $interval;
public readonly int $recurrences;
public readonly bool $include_start_date;
public readonly bool $include_end_date;
/* Методи */
public __construct(
         DateTimeInterface $start,
         DateInterval $interval,
         int $recurrences,
         int $options = 0
)
public __construct(
         DateTimeInterface $start,
         DateInterval $interval,
         DateTimeInterface $end,
         int $options = 0
)
public __construct(string $isostr, int $options = 0)
public static createFromISO8601String(string $specification, int $options = 0): static
}

Претходно дефинирани константи

DatePeriod::EXCLUDE_START_DATE int

Исклучи датум на почеток, се користи во (PHP 5 >= 5.3.0, PHP 7, PHP 8).

DatePeriod::INCLUDE_END_DATE int

Вклучи датум на крај, се користи во (PHP 5 >= 5.3.0, PHP 7, PHP 8).

Својства

recurrences

Минималната количина на инстанци што ги враќа итераторот.

Ако бројот на повторувања е експлицитно поминат преку recurrences параметарот во конструкторот на DatePeriod инстанца, тогаш овој параметар ја содржи оваа вредност, plus еден ако датумот на почеток не е оневозможен преку DatePeriod::EXCLUDE_START_DATE, plus еден ако датумот на крај е овозможен преку DatePeriod::INCLUDE_END_DATE.

Ако бројот на повторувања не е експлицитно поминат, тогаш овој параметар ја содржи минималната количина на вратени инстанци. Ова би било 0, plus еден ако датумот на почеток не е оневозможен преку DatePeriod::EXCLUDE_START_DATE, plus еден ако датумот на крај е овозможен преку DatePeriod::INCLUDE_END_DATE.

<?php
$start
= new DateTime('2018-12-31 00:00:00');
$end = new DateTime('2021-12-31 00:00:00');
$interval = new DateInterval('P1M');
$recurrences = 5;

// recurrences explicitly set through the constructor
$period = new DatePeriod($start, $interval, $recurrences, DatePeriod::EXCLUDE_START_DATE);
echo
$period->recurrences, "\n";

$period = new DatePeriod($start, $interval, $recurrences);
echo
$period->recurrences, "\n";

$period = new DatePeriod($start, $interval, $recurrences, DatePeriod::INCLUDE_END_DATE);
echo
$period->recurrences, "\n";

// recurrences not set in the constructor
$period = new DatePeriod($start, $interval, $end);
echo
$period->recurrences, "\n";

$period = new DatePeriod($start, $interval, $end, DatePeriod::EXCLUDE_START_DATE);
echo
$period->recurrences, "\n";

Пример #1 Пример што покажува затворачка ознака што го опфаќа последниот нов ред

5
6
7
1
0

Види исто така Пример #1 Различни вредности за.

include_end_date

Дали да се вклучи датумот на крај во множеството датуми што се повторуваат или не.

include_start_date

Дали да се вклучи датумот на почеток во множеството датуми што се повторуваат или не.

start

Датумот на почеток на периодот.

current

За време на итерацијата, ова ќе го содржи тековниот датум во рамките на периодот.

end

Датумот на крај на периодот.

interval

ISO 8601 спецификација за повторлив интервал.

Дневник на промени

Верзија = NULL
8.4.0 Константите на класата сега се типизирани.
8.2.0 На DatePeriod::INCLUDE_END_DATE "константа и" include_end_date својство е додадено.
8.0.0 DatePeriod implements IteratorAggregate сега. Претходно, Траверзабилно беше имплементирано наместо тоа.

Содржина

Белешки од корисници 1 белешка

mail на pascalhofmann dot de
пред 9 години
When looping over a DatePeriod object, the returned objects always implement DateTimeInterface. The exact type returned depends on how the DatePeriod was created. If $start was a DateTimeImmutable, the objects returned will be of type DateTimeImmutable. If a DateTime object was used, the objects returned will be of type DateTime.
На оваа страница

Автоматски outline од активната документација.

Насловите ќе се појават тука по вчитување.

Попрегледно читање

Примерите, changelog табелите и user notes се визуелно издвоени за да не се губат во долгата содржина.

Брз совет Користи го outline-от Скокни директно на главните секции од активната страница.
Извор Оригиналниот линк останува достапен Кога ти треба целосен upstream context, отвори го PHP.net во нов tab.