Format a date, using PHP date(), strftime() or other special strings (see arguments).

This is designed to work the same wa as PHP’s date() but be able to accept any common format used in ProcessWire. This is helpful in reducing code in places where you might have logic determining when to use date(), strftime(), or wireRelativeTimeStr().

This is the procedural version of the $datetime->date() method.

Example

echo wireDate('Y-m-d H:i:s'); // Outputs: 2019-01-20 06:48:11
echo wireDate('relative', '2019-01-20 06:00'); // Outputs: 48 minutes ago

Usage

// basic usage
$string = wireDate();

// usage with all arguments
$string = wireDate($format = '', $ts = null);

Arguments

NameType(s)Description
format (optional)string, int

Use any PHP date() or strftime() format, or one of the following:

  • relative for a relative date/time string.
  • relative- for a relative date/time string with no tense.
  • rel for an abbreviated relative date/time string.
  • rel- for an abbreviated relative date/time string with no tense.
  • r for an extra-abbreviated relative date/time string.
  • r- for an extra-abbreviated relative date/time string with no tense.
  • ts makes it return a unix timestamp.
  • Specify blank string to make it use the system date format ($config->dateFormat) .
  • If given an integer and no second argument specified, it is assumed to be the second ($ts) argument.
ts (optional)int, string, null

Optionally specify the date/time stamp or strtotime() compatible string. If not specified, current time is used.

Return value

string bool

Formatted date/time, or boolean false on failure


Functions methods and properties

API reference based on ProcessWire core version 3.0.148

Twitter updates

  • This week we’ve got a couple of really useful API-side improvements to the core in 3.0.151, including predefined image settings and static language translation improvements— More
    21 February 2020
  • New post in the blog about all the fun we had driving around a DDOS attack on our forums, how we got it back under control, and what we learned along the way. Plus PW 3.0.150 dev details and links! More
    7 February 2020
  • New post: ProcessWire core updates (January 31, 2020)— More
    31 January 2020

Latest news

  • ProcessWire Weekly #302
    In the 302nd issue of ProcessWire Weekly we're going to dig into ProcessWire 3.0.151, introduce a new third party module called PrivacyWire, and showcase some interesting ProcessWire highlights from the past week or so. Read on!
    Weekly.pw / 22 February 2020
  • ProcessWire 3.0.151 core updates
    Blog / 21 February 2020
  • Subscribe to weekly ProcessWire news

“We were really happy to build our new portfolio website on ProcessWire! We wanted something that gave us plenty of control on the back-end, without any bloat on the front end - just a nice, easy to access API for all our content that left us free to design and build however we liked.” —Castus, web design agency in Sheffield, UK