Just wanted to record some nuance with the answer by
lorem monkey
The suggested method might cause issues with when using time zones.
scenario: consider current system time is 2018-01-01 00:20:00 UTC
and system default time zone is set to UTC.
date['Y']
will give you 2018
if you are doing something like:
$startDate = new DateTime['first day of january '.date['Y'], new DateTimeZone['America/New_York']];
This will compute to 'first day of january 2018'
but you actually needed the first date of your current year in America/New_York,
which is still 2017.
Stop dropping the ball man, its not new year yet!
So it is better to just do
$startDate = new DateTime['first day of january', new DateTimeZone['America/New_York']];
And then do the modifications as needed by using the DateTime::modify[]
function.
Relative date formats are fun.
My scenario: I wanted to get the bounds of this year as in
2018-01-01 00:00:00
to2018-12-31 23:59:59
This can be achieved in two ways with relative date formats.
one way is to use the DateTime::modify[]
function on the object.
$startDate = [new DateTime['now', new DateTimeZone["America/New_York"]]];
$endDate = [new DateTime['now', new DateTimeZone["America/New_York"]]];
$startDate->modify["january"]
->modify["first day of this month"]
->modify["midnight"];
$endDate->modify["next year"]
->modify["january"]
->modify["first day of this month"]
->modify["midnight"]->modify["-1 second"];
var_dump[[$startDate, $endDate]];
Try out here: //www.tehplayground.com/Qk3SkcrCDkNJoLK2
Another way to do this is to separate the relative strings with a comma like so:
$startDate = [new DateTime['first day of january', new DateTimeZone["America/New_York"]]];
$endDate = [new DateTime['next year, first day of january, -1 second', new DateTimeZone["America/New_York"]]];
var_dump[[$startDate, $endDate]];
Try out here: //www.tehplayground.com/hyCqXLRBlhJbCyks
'yesterday'
Midnight of yesterday
"yesterday 14:00"
'midnight'
The time is set to 00:00:00
'today'
The time is set to 00:00:00
'now'
Now - this is simply ignored
'noon'
The time is set to 12:00:00
"yesterday noon"
'tomorrow'
Midnight of tomorrow
'back of' hour
15 minutes past the specified hour
"back of 7pm", "back of 15"
'front of' hour
15 minutes before the specified hour
"front of 5am", "front of 23"
'first day of'
Sets the day of the first of the current month. This phrase is usually best used together with a month name following it as it only effects the current month
"first day of January 2008"
'last day of'
Sets the day to the last day of the current month. This phrase is usually best used together with a month name following it as it only effects the current month
"last day of next month"
ordinal
space
dayname
space
'of'
Calculates the x
-th week day of the current month.
"first sat of July 2008"
'last' space
dayname
space
'of'
Calculates the last week day of the current month.
"last sat of July 2008"
number
space
? [unit
| 'week']
Handles relative time items where the value is a number.
"+5 weeks", "12 day", "-7 weekdays"
ordinal
space
unit
Handles relative time items where the value is text.
"fifth day", "second month"
'ago'
Negates all the values of previously found relative time items.
"2 days ago", "8 days ago 14:00", "2 months 5 days ago", "2 months ago 5 days", "2 days ago"
dayname
Moves to the next day of this name. [See note]
"Monday"
reltext
space
'week'
Handles the special format "weekday + last/this/next week".
"Monday next week"
[PHP 4, PHP 5, PHP 7, PHP 8]
date — Format a Unix timestamp
Description
date[string $format
, ?int $timestamp
= null
]: string
Parameters
format
Format accepted by DateTimeInterface::format[].
timestamp
The optional timestamp
parameter is an int Unix timestamp that defaults to the current local time if timestamp
is omitted or null
. In other words, it defaults to the value of
time[].
Return Values
Returns a formatted date string. If a non-numeric value is used for timestamp
, false
is returned and an E_WARNING
level error is emitted.
Errors/Exceptions
Every call to a date/time function will generate a
E_WARNING
if the time zone is not valid. See also date_default_timezone_set[]
Changelog
8.0.0 | timestamp is nullable now.
|
Examples
Example #1 date[] examples
You can prevent a recognized character in the format string from being expanded by escaping it with a preceding backslash. If the character with a backslash is already a special sequence, you may need to also escape the backslash.
Example #2 Escaping characters in date[]
It is possible to use date[] and mktime[] together to find dates in the future or the past.
Example #3 date[] and mktime[] example
Note:
This can be more reliable than simply adding or subtracting the number of seconds in a day or month to a timestamp because of daylight saving time.
Some examples of date[] formatting. Note that you should escape any other characters, as any which currently have a special meaning will produce undesirable results, and other characters may be assigned meaning in future PHP versions. When escaping, be sure to use single quotes to prevent characters like \n from becoming newlines.
Example #4 date[] Formatting
To format dates in other languages, IntlDateFormatter::format[] can be used instead of date[].
Notes
Note:
To generate a timestamp from a string representation of the date, you may be able to use strtotime[]. Additionally, some databases have functions to convert their date formats into timestamps [such as MySQL's » UNIX_TIMESTAMP function].
See Also
- DateTimeImmutable::__construct[] - Returns new DateTimeImmutable object
- DateTimeInterface::format[] - Returns date formatted according to given format
- gmdate[] - Format a GMT/UTC date/time
- idate[] - Format a local time/date part as integer
- getdate[] - Get date/time information
- getlastmod[] - Gets time of last page modification
- mktime[] - Get Unix timestamp for a date
- IntlDateFormatter::format[] - Format the date/time value as a string
- time[] - Return current Unix timestamp
- Predefined DateTime Constants
There are no user contributed notes for this page.