webCOMAND

DATE _FORMAT()

Formats a date, time or timestamp value according to the format string.

Prototype

string DATE_FORMAT(mixed $timestamp, string $format)

Parameters

  • timestamp - A date ("YYYY-MM-DD"), time ("HH:MM:SS") or timestamp ("YYYY-MM-DD HH:MM:SS").
  • format - A string of text with special codes that start with the % character followed by a format specifier character, which will be replaced with the corresponding value based on the timestamp.

Format Codes

Code Description
%a Abbreviated weekday name (Sun to Sat)
%b Abbreviated month name (Jan to Dec)
%c Numeric month name (0 to 12)
%D Day of the month as a numeric value, followed by suffix (1st, 2nd, 3rd, ...)
%d Day of the month as a numeric value (01 to 31)
%e Day of the month as a numeric value (0 to 31)
%f Microseconds (000000 to 999999)
%H Hour (00 to 23)
%h Hour (00 to 12)
%I Hour (00 to 12)
%i Minutes (00 to 59)
%j Day of the year (001 to 366)
%k Hour (0 to 23)
%l Hour (1 to 12)
%M Month name in full (January to December)
%m Month name as a numeric value (00 to 12)
%p AM or PM
%r Time in 12 hour AM or PM format (hh:mm:ss AM/PM)
%S Seconds (00 to 59)
%s Seconds (00 to 59)
%T Time in 24 hour format (hh:mm:ss)
%U Week where Sunday is the first day of the week (00 to 53)
%u Week where Monday is the first day of the week (00 to 53)
%V Week where Sunday is the first day of the week (01 to 53). Used with %X
%v Week where Monday is the first day of the week (01 to 53). Used with %X
%W Weekday name in full (Sunday to Saturday)
%w Day of the week where Sunday=0 and Saturday=6
%X Year for the week where Sunday is the first day of the week. Used with %V
%x Year for the week where Monday is the first day of the week. Used with %V
%Y Year as a numeric, 4-digit value
%y Year as a numeric, 2-digit value

Return

The format string with the format codes replaced by the corresponding value based on the timestamp.  NULL is returned if there is an error, such as an invalid timestamp.

Example

SELECT OID, DATE_FORMAT(META(LastModified),'%b %D, %Y') AS DateModified FROM User

Related

cTemplate #FORMAT(), MySQL DATE_FORMAT()