DateTime в PHP

  • PHP
  • 16,434
  • 0
  • 1
  • 0
  • 4 года назад

Начиная с версии 5.2 в PHP появился такой тип данных как DateTime. Попробуем в этой статье разобраться почему лучше использовать его вместо старых функций date() и time().

Функция date() используется для строкового отображения даты/времени. Функция принимает два параметра, 1-ый - формат возвращаемой строки, а второй - само значение даты. По умолчанию второй параметр принимает значение текущего момента времени, либо можно указать отметку времени в unix формате (timestamp).

<?php

// Текущая дата
echo date("Y-m-d", time());

// 2013-12-01
echo date("Y-m-d", 1385925192);

Функция time() возвращает текущее время в unix формате (timestamp).

<?php

// Текущее время, unix формат
echo time();

Datetime()

Объект Datetime впервые был представлен в PHP версии 5.2, он содержит в себе множество вспомогательных объектов, для решения проблем, с которыми вам приходилось сталкиваться при использовании функций date() и time(). Также был представлен объект DateTimeZone, который управляет часовым поясом, объект DateInterval соответствует интервалу времени (например 2 дня) от настоящего момента, DatePeriod показывает разницу во времени между двумя разными датами. Основное преимущество использования DateTime перед старыми функциями заключается в том, что значения дат проще изменять. Если вы хотите получить значение времени и даты при помощи функции date(), то вы напишите следующее:

<?php

echo date("l jS \of F Y h:i:s A");

А вот пример для установки часового пояса:

<?php

date_default_timezone_set('UTC');
echo date("l jS \of F Y h:i:s A");

Проблема возникает при необходимости изменить или сравнить две отметки времени, DateTime имеет методы modify() и diff() упрощающие задачу. Преимущества DateTime проявляются когда вы манипулируете значениями дат.

Сначала объект надо инициализировать

<?php

$date = new DateTime();

Конструктор этого класса принимает два параметра. Первый - значение времени, вы можете использовать строку в формате функции date, время в формате Unix, интервал или период. Второй параметр - часовой пояс.

<?php

// Установка даты
$date = new DateTime('2000-01-01');

// Установка даты с часовым поясом
$date = new DateTime('2000-01-01', new DateTimeZone('Pacific/Nauru'));

// Установка даты на 4 дня вперед
$date = new DateTime('+4 days');

Вывод форматированной даты

Объект DateTime может работать также как и функция date, всего лишь необходимо вызвать метод format() указав формат возвращаемой строки.

<?php

echo $date->format('Y-m-d');

Вывод отметки времени (timestamp)

Для вывода отметки времени в формате Unix существует метод getTimestamp().

~~~{.php} <?php

$date = new DateTime(); echo $date->getTimestamp();


### Установка даты

Несмотря на то, что значение даты вы указываете при создании объекта класса, вы можете позже изменять это значение.

### Изменение даты

Для изменения даты используйте метод `setDate()`.

~~~php
<?php

$date = new DateTime();

// 2001-02-03
$date->setDate(2001, 2, 3);
echo $date->format('Y-m-d');

Изменение времени

Для изменения значения времени существует метод setTime().

<?php

$date = new DateTime();

// 2013-12-01 14:55:00
$date->setTime(14, 55);
echo $date->format('Y-m-d H:i:s');

Изменение метки timestamp

Для этого придуман метод setTimestamp().

<?php

$date = new DateTime();

// 2013-11-28 19:13:19
$date->setTimestamp(1385665999);
echo $date->format('Y-m-d H:i:s');

Установка часового пояса

Второй параметр при создании объекта - DateTimeZone, он позволяет назначить часовой пояс нашему объекту. Это означает, что мы сможем легко сравнивать два значения времени из разных часовых поясов и получать корректную разницу.

<?php

// 2013-12-01 13:45:00+13:45
$date = new DateTime('2013-12-01', new DateTimeZone('Pacific/Chatham'));
echo $date->format('Y-m-d H:i:sP');

Также для установки этого значения существует метод setTimezone().

<?php

$date = new DateTime('2013-12-01');

// 2013-12-01 13:45:00+13:45
$date->setTimezone(new DateTimeZone('Pacific/Chatham'));
echo $date->format('Y-m-d H:i:sP');

// 2013-11-30 19:00:00-05:00
$date->setTimezone(new DateTimeZone('America/Toronto'));
echo $date->format('Y-m-d H:i:sP');

Полный список часовых поясов можно просмотреть на php.net.

Как добавить дни к значению даты

Для изменения значения даты в объекте DateTime можно использовать метод modify(). Он принимает в качестве параметра строковое значение дней, месяцев, года. Например, если хотите прибавить несколько дней, например 3 дня, один месяц и один год:

<?php

$date = new DateTime('2013-12-01');
$date->modify('+3 day');

// 2013-12-04
echo $date->format('Y-m-d');

$date = new DateTime('2013-12-01');
$date->modify('+1 month');

// 2014-01-01
echo $date->format('Y-m-d');

Сравнение двух дат

<?php

$date1 = new DateTime('May 13th, 1986');
$date2 = new DateTime('October 28th, 1989');

$difference = $date1->diff($date2);

Код выше даст нам разницу двух дат в виде DateInterval.

DateInterval Object
(
   [y] => 3
   [m] => 5
   [d] => 15
   [h] => 0
   [i] => 0
   [s] => 0
   [invert] => 0
   [days] => 1264
)

Конвертация номера месяца и имени месяца

Довольно часто приходится получать имя месяца из его порядкового номера, для этого всего лишь нужно указать формат “F” в качестве первого параметра

<?php

$monthName = date("F", mktime(0, 0, 0, $monthNum));

При использовании класса DateTime можно применить метод format().

<?php

$date = new DateTime('2000-'.$monthNum.'-01');
$monthName = $date->format("F");

Получаем количество недель в месяце

Следующий пример поможет вам получить количество недель в определенном месяце года.

<?php

function weeks_in_month($month, $year)
{
   $startDate = new DateTime();
   $startDate->setDate($year, $month, 1);

   $loopDate = $startDate;
   $week = 1;
   for($i = $startDate->format('d'); $i <= cal_days_in_month(CAL_GREGORIAN, $month, $year); $i++)
   {
       if($loopDate->format('w') % 7 == 0)
       {
           $week++;
       }

       $loopDate->modify('+1 day');
   }

   return $week;
}

echo '<p>Jan '.weeks_in_month(1, 2014).'</p>';
echo '<p>Feb '.weeks_in_month(2, 2014).'</p>';
echo '<p>Mar '.weeks_in_month(3, 2014).'</p>';
echo '<p>Apr '.weeks_in_month(4, 2014).'</p>';
echo '<p>May '.weeks_in_month(5, 2014).'</p>';
echo '<p>Jun '.weeks_in_month(6, 2014).'</p>';
echo '<p>Jul '.weeks_in_month(7, 2014).'</p>';
echo '<p>Aug '.weeks_in_month(8, 2014).'</p>';
echo '<p>Sep '.weeks_in_month(9, 2014).'</p>';
echo '<p>Oct '.weeks_in_month(10, 2014).'</p>';
echo '<p>Nov '.weeks_in_month(11, 2014).'</p>';
echo '<p>Dec '.weeks_in_month(12, 2014).'</p>';
?>