[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.