downloads | documentation | faq | getting help | mailing lists | licenses | wiki | reporting bugs | php.net sites | conferences | my php.net

search for in the

DateTime::getLastErrors> <DateTime::diff
[edit] Last updated: Fri, 17 May 2013

view this page in

DateTime::format

date_format

(PHP 5 >= 5.2.0)

DateTime::format -- date_formatReturns date formatted according to given format

Description

Object oriented style

public string DateTime::format ( string $format )

Procedural style

string date_format ( DateTime $object , string $format )

Returns date formatted according to given format.

Parameters

object

Procedural style only: A DateTime object returned by date_create()

format

Format accepted by date().

Return Values

Returns the formatted date string on success or FALSE on failure.

Examples

Example #1 DateTime::format() example

Object oriented style

<?php
$date 
= new DateTime('2000-01-01');
echo 
$date->format('Y-m-d H:i:s');
?>

Procedural style

<?php
$date 
date_create('2000-01-01');
echo 
date_format($date'Y-m-d H:i:s');
?>

The above example will output:

2000-01-01 00:00:00

Notes

This method does not use locales. All output is in English.

See Also

  • date() - Format a local time/date


DateTime::getLastErrors> <DateTime::diff
[edit] Last updated: Fri, 17 May 2013
 
add a note add a note User Contributed Notes DateTime::format - [4 notes]
up
6
ca at agercon dot dk
1 year ago
The date_format can be use to get the last day of February:

<?php

function last_day_of_feb ($year) {
# The 0th day of a month is the same as the last day of the month before
       
$ultimo_feb_str = $year . "-03-00";
       
$ultimo_feb_date = date_create($ultimo_feb_str);
       
$return = date_format($ultimo_feb_date, "Y-m-d");
        return
$return;
}

echo
last_day_of_feb(2011) . "\n"; # 2011-02-28
echo last_day_of_feb(2012) . "\n"; # 2011-02-29

?>
up
4
craig dot constable at gmail dot com
1 year ago
Using a datetime field from a mysql database e.g. "2012-03-24 17:45:12"

<?php

$result
= mysql_query("SELECT `datetime` FROM `table`");
$row = mysql_fetch_row($result);
$date = date_create($row[0]);

echo
date_format($date, 'Y-m-d H:i:s');
#output: 2012-03-24 17:45:12

echo date_format($date, 'd/m/Y H:i:s');
#output: 24/03/2012 17:45:12

echo date_format($date, 'd/m/y');
#output: 24/03/12

echo date_format($date, 'g:i A');
#output: 5:45 PM

echo date_format($date, 'G:ia');
#output: 05:45pm

echo date_format($date, 'g:ia \o\n l jS F Y');
#output: 5:45pm on Saturday 24th March 2012

?>
up
-6
eggerjohansi at gmail dot com
3 years ago
if you want to use e.g. german weekdays you could add the following class as a temporary solution...
<?php
class DateTimeGerman extends DateTime {
    public function
format($format) {
       
$english = array('Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday', 'Sunday');
       
$german = array('Montag', 'Dienstag', 'Mittwoch', 'Donnerstag', 'Freitag', 'Samstag', 'Sonntag');
        return
str_replace($english, $german, parent::format($format));
    }
}
?>
it hasn't anything to do with nice programming but it works if you construct a
<?php
$dt
= new DateTimeGerman();
?>
instead of
<?php
$dt
= new DateTime();
?>
up
-2
James Meyer
2 years ago
A note about version differences - the results of this function differ significantly from php 5.2.x to 5.3.x . 

The 5.2 implementations will often parse to non-sensical values, such as:

1964/11-12: 1964/-99999/-99999
12/11-1964: -99999/12/11
12-31-1964: -99999/-99999/-99999
11121875: 1112/01/187
01321901: 0132/01/190

(this one makes sense, but was a poor guess)
31/12/1964: 1964/01/12

In 5.3+, these all come back as false, as I would expect.  5.2 was just a little optimistic about it's ability to parse dates, I guess.

 
show source | credits | stats | sitemap | contact | advertising | mirror sites