PHP: Относительные форматы

Относительные форматы

На этой странице описаны относительные форматы даты/времени, которые понимает парсер функций strtotime(), DateTime и date_create().

**Используемые символы**
Описание	Формат
`dayname` (наименование дня недели)	'sunday' \| 'monday' \| 'tuesday' \| 'wednesday' \| 'thursday' \| 'friday' \| 'saturday' \| 'sun' \| 'mon' \| 'tue' \| 'wed' \| 'thu' \| 'fri' \| 'sat'
`daytext` (интервалы в неделях)	'weekday' \| 'weekdays'
`number`	[+-]?[0-9]+
`ordinal` (порядковые числительные и указатели)	'first' \| 'second' \| 'third' \| 'fourth' \| 'fifth' \| 'sixth' \| 'seventh' \| 'eighth' \| 'ninth' \| 'tenth' \| 'eleventh' \| 'twelfth' \| 'next' \| 'last' \| 'previous' \| 'this'
`reltext` (указатели)	'next' \| 'last' \| 'previous' \| 'this'
`space` (символы пробела и табуляции)	[ \t]+
`unit` (интервалы)	(('sec' \| 'second' \| 'min' \| 'minute' \| 'hour' \| 'day' \| 'fortnight' \| 'forthnight' \| 'month' \| 'year') 's'?) \| 'weeks' \| `daytext`

**Нотации, основанные на днях**
Формат	Описание	Примеры
'yesterday'	Полночь вчера	"yesterday 14:00"
'midnight'	Время устанавливается в 00:00:00
'today'	Время устанавливается в 00:00:00
'now'	Текущее время
'noon'	Время устанавливается в 12:00:00	"yesterday noon"
'tomorrow'	Полночь завтра
'back of' `hour`	Без 15 минут заданный час	"back of 7pm", "back of 15"
'front of' `hour`	15 минут заданного часа	"front of 5am", "front of 23"
'first day' ' of'?	Устанавливает первый день текущего месяца. При использовании с указанием на месяц - устанавливает первый день заданного месяца.	"first day of January 2008"
'last day' ' of'?	Устанавливает последний день текущего месяца. При использовании с указанием на месяц - устанавливает последний день заданного месяца.	"last day of next month"
`ordinal` `space` `dayname` `space` 'of'	Вычисляет `x` день недели текущего или заданного месяца.	"first sat of July 2008"
'last' `space` `dayname` `space` 'of'	Вычисляет последний день недели текущего или заданного месяца.	"last sat of July 2008"
`number` `space`? (`unit` \| 'week')	Вычисляет относительное время при использовании числовых значений периода.	"+5 weeks", "12 day", "-7 weekdays"
`ordinal` `space` `unit`	Вычисляет относительное время при использовании строковых значений периода.	"fifth day", "second month"
'ago'	Вычитает все значения из последнего полученного момента времени.	"2 days ago", "8 days ago 14:00", "2 months 5 days ago", "2 months ago 5 days", "2 days ago ago"
`dayname`	Перемещается на следующий день указанного дня недели.	"Monday"
`reltext` `space` 'week'	Разбирает специфичный формат "weekday + last/this/next week".	"Monday next week"

Замечание:
Относительные выражения всегда обрабатываются после не являющихся относительными. Например, "+1 week july 2008" эквивалентно "july 2008 +1 week".

Исключением этого правила являются: "yesterday", "midnight", "today", "noon" и "tomorrow". Записи "tomorrow 11:00" и "11:00 tomorrow" отличаются. Если принять сегодняшнюю дату за "July 23rd, 2008", то первая запись возвращает "2008-07-24 11:00", а вторая "2008-07-24 00:00". Причина такого поведения в том, что эти пять выражений влияют непосредственно на время.

Замечание:
Следует обратить внимание на приведённые ниже замечания относительно текущего дня недели и дня недели, указанного в строке даты/времени. Текущий день недели может быть вычислен из независимой части строки даты/времени.

"dayname" не сдвигает дату на другой день. (Например: "Wed July 23rd, 2008" означает "2008-07-23").

"number dayname" не сдвигает дату на другой день. (Например: "1 wednesday july 23rd, 2008" означает "2008-07-23").

"number week dayname" добавляет соответствующее число недель, но не сдвигает дату на другой день. В этом случае имеют место два различных блока "number week" и "dayname". (Например: "+1 week wednesday july 23rd, 2008" означает "2008-07-30").

"ordinal dayname" сдвигает дату на другой день. (Например: "last wednesday july 23rd, 2008" означает "2008-07-30").

"number week ordinal dayname" добавляет соответствующее число недель, а после сдвигает дату на другой день. В этом случае имеют место два различных блока "number week" и "ordinal dayname". (Например: "+1 week first wednesday july 23rd, 2008" означает "2008-08-06").

"ordinal dayname 'of' " не сдвигает дату на другой день. (Например: "first wednesday of july 23rd, 2008" означает "2008-07-02", потому как определённые фразы с 'of' сбрасывают день месяца на '1' и в этом случае игнорируется '23rd').

Также следует обратить внимание, что "of" в "ordinal space dayname space 'of' " и "'last' space dayname space 'of' " имеет особый смысл.

Устанавливает день месяца в 1.

"ordinal dayname 'of' "не сдвигает дату на другой день. (Например: "first tuesday of july 2008" означает "2008-07-01").

"ordinal dayname" сдвигает дату на другой день. (Например: "first tuesday july 2008" означает "2008-07-08", смотрите также 4-й пункт предыдущего замечания).

"'last' dayname 'of' " получает последний в месяце dayname. (Например: "last wed of july 2008" означает "2008-07-30")

"'last' dayname" получает последний dayname перед текущим днём. (Например: "last wed july 2008" означает "2008-06-25"; "july 2008" устанавливает дату в "2008-07-01", а после "last wed" смещает дату к предыдущей среде, а именно к "2008-06-25").

Замечание:
Относительные значения в месяцах рассчитываются исходя из их продолжительности. Например, из "+2 month 2011-11-30" получится "2012-01-30". Это связано с тем, что ноябрь состоит из 30 дней, а декабрь из 31 дня, что составляет 61 дней.

Замечание:
Под числом (number) подразумевается целое число (integer); Если будет указано десятичное число, то десятичная точка (или запятая) будет рассматриваться как разделитель. К примеру, '+1.5 hours' будет считаться как '+1 5 hours', а не '+1 hour +30 minutes'.

Список изменений

Версия	Описание
7.0.8	Недели всегда начинаются с понедельника. Ранее можно было определять начало недели с воскресенья.

add a note

User Contributed Notes 13 notes

down

Mark Simon ¶

8 years ago


Note that expressions such as “last day of” and “first day of” imply a day of a month, not, for example of the year or week.

So, expressions, such as “first day of this year” will give the first day of this month, with no apparent regard for the year.

As powerful as the parser is, it can lead to disappointing or confusing results.

down

Igor ¶

6 years ago


@Mark Simon, while you're correct, it's still possible to get first/last day of the year using relative date formats, though in a somewhat roundabout way. 
<?php
    echo gmdate('F j, Y', strtotime('first day of january this year'));;
    /* Output: January 1, 2018 */

    echo gmdate('F j, Y', strtotime('last day of december this year'));;
    /* Output: December 31, 2018 */
?>

down

InvisibleSmiley ¶

3 years ago


Both dayname AND daytext ("weekday"/"weekdays") reset time information to 0.

Depending on how accurate you need it, the following may work for you:

new DateTime('last weekday ' . date('H:i:s'));
new DateTime('last weekday ' . (new DateTime())->format('H:i:s.u'));

(As documented, date() doesn't handle microseconds.)

down

oguzkonya34 at gmail dot com ¶

12 years ago


April 1st, 2012 is Sunday. You might expect to get April 2nd, 2012 with 'Monday next week', however this:

<?php
    echo date('F jS, Y', strtotime('Monday next week 2012-04-01'));
?>

returns April 9th, 2012. To get April 2nd, you need to use this:

<?php
    echo date('F jS, Y', strtotime('next Monday 2012-04-01'));
?>

Apparently 'next week' advances the week if and only if the day is Sunday. This:

<?php
    echo date('F jS, Y', strtotime('Monday next week 2012-03-31'));
?>

would still return April 2nd.

down

phpnet at rudde dot org ¶

8 years ago


Get the first day of a month, in a typical calendar month, typically the Monday in the first week of the month. In my example when the code is ran at 2016-04-06, 1st of april will be a Friday, since Calendars typically start on monday, this is the date you might want, in this case this would be 28th of March. 

<?php
/* Code ran at 2016-04-06 */
$date = new DateTime('first day of this month');
$date->modify('monday this week');

echo $date->format('Y-m-d');
/* Output: 2016-03-28 */
?>

down

geneticdrift ¶

13 years ago


Month skipping has issues with number of days in the month.

'+1 month' may move to the following month if the next month has less days than the current:

<?php print date('d M Y H:i:s', strtotime('+1 month', strtotime('Thu Mar 31 19:50:41 IST 2011'))); ?>
Prints: 01 May 2011 19:50:41

But with 'last day of +1 month' the result is different:

<?php print date('d M Y H:i:s', strtotime('last day of +1 month', strtotime('Thu Mar 31 19:50:41 IST 2011'))); ?>
Prints: 30 Apr 2011 19:50:41

(PHP 5.3.3)

down

chris at burnhamup dot com ¶

11 years ago


Using strtotime('DAYNAME') like strtotime('Tuesday') returns midnight on the specified day. It doesn't preserve the current time or the time passed into the function.

down

yaroslav429 at gmail dot com ¶

3 years ago


@Igor, @Mark Simon, seems that was fixed.

PHP 7.4.10
<?php
new DateTimeImmutable('midnight first day of');
/* date: 2020-09-01 00:00:00.0 UTC (+00:00) */

new DateTimeImmutable('midnight first day of next month next year');
/* date: 2021-10-01 00:00:00.0 UTC (+00:00) */
?>

down

php at rcs dot us ¶

7 years ago


I'm not sure if this is a bug or expected. As erwin points out :

"first monday of may 2011" is invalid, but "first monday may 2011" does work. Simply omit "of" if above examples do not work.

This still applies in 5.5 as well, and I ran into it while building out a utility to check if a day was a holiday. 

Meaning "fourth day July 2016" /works/, but "fourth day of July 2016" does not. It will return an error. I emphasize works, because "fourth day July 2016" actually returns 2016-07-05. So you'll need "third day July 2016" for the Fourth of July.

However, "Last Monday May 2016" and "Last Monday of May 2016" ( for Memorial Day ) are both /valid/, but produce different results. The first returns 2016-04-25, which is incorrect, while the second returns the correct 2016-05-30.

down

-1

matt ¶

12 years ago


If the ordinal being used is "last" and the next month is n, use the "n 1". Otherwise, if the previous month is p and it has d number of days in it, use "p d".



For example: "last thursday of November" becomes "last thursday December 1" and "fourth thursday of November" becomes "fourth thursday September 30th"



Hopes this helps someone out there.

down

-16

Pseudoname ¶

9 years ago


oguzkonya34 at gmail dot com
Point of correction:
Apparently 'next week' advances the week if and only if the day is Sunday. This:
<?php
    echo date('F jS, Y', strtotime('Monday next week 2012-03-31'));
?>
would still return April 2nd.
Quote "
Apparently 'next week' advances the week if and only if the day is Sunday. "
Not really. 2012-03-31 would be Saturday if 2012-04-01 is Sunday as you mentioned. Then Monday next week for 2012-03-31 is April 2nd which is correct.

down

-4

mike ¶

3 years ago


in case of somone wonder 'last day of 1 month ago' is also posible (not only month names)

down

-20

scragar at gmail dot com ¶

12 years ago


Just for those who want the last day of the year without calling the function twice:

<?php
echo date('Y-m-d',
    strToTime('1/1 next year -1 day')
);
//   2011-12-31
?>

For reference this is actually saying "Take the first day of the first month next year, then subtract 1 day".

add a note