The $datetime API variable provides helpers for working with dates/times and conversion between formats.

Click any linked item for full usage details and examples. Hookable methods are indicated with the icon. In addition to those shown below, the WireDateTime class also inherits all the methods and properties of: Wire.

Common / Advanced

Show “$datetime”             Show Arguments        

Common

NameReturnSummary 
$datetime->date()
string or boolFormat a date, using PHP date(), strftime() or other special strings (see arguments).
$datetime->relativeTimeStr($ts)
stringGiven a unix timestamp (or date string), returns a formatted string indicating the time relative to now
$datetime->stringToTimestamp(string $str, string $format)
intGiven a date/time string and expected format, convert it to a unix timestamp

Advanced

NameReturnSummary 
$datetime->convertDateFormat(string $format, string $type)
stringGiven a PHP date() format, convert it to either 'js', 'strftime' or 'regex' format
$datetime->getDateFormats()
arrayReturn all predefined PHP date() formats for use as dates
$datetime->getTimeFormats()
arrayReturn all predefined PHP date() formats for use as times

Additional methods and properties

In addition to the methods and properties above, WireDateTime also inherits the methods and properties of these classes:

API reference based on ProcessWire core version 3.0.66