How to Use DateTime Class in PHP: Syntax and Examples

Use the DateTime class in PHP to create, modify, and format dates and times easily. Instantiate it with new DateTime(), then use methods like format() to display or modify() to change the date/time.

Syntax

The DateTime class is used to work with dates and times in PHP. You create a new date/time object by calling new DateTime(). You can pass a date/time string to set a specific date or leave it empty for the current date/time. Use format() to display the date/time in a specific style, and modify() to change it.

php

<?php
// Create a new DateTime object for current date/time
$date = new DateTime();

// Create a DateTime object for a specific date/time
$specificDate = new DateTime('2024-06-01 15:30:00');

// Format the date/time
echo $specificDate->format('Y-m-d H:i:s') . "\n";

// Modify the date/time
$specificDate->modify('+1 day');
echo $specificDate->format('Y-m-d H:i:s') . "\n";
?>

Output

2024-06-01 15:30:00
2024-06-02 15:30:00

Example

This example shows how to create a DateTime object for the current time, format it, add 2 weeks, and display the new date.

php

<?php
// Create DateTime object for now
$now = new DateTime();

// Display current date/time
echo "Current date/time: " . $now->format('Y-m-d H:i:s') . "\n";

// Add 2 weeks
$now->modify('+2 weeks');

// Display new date/time
echo "Date/time after 2 weeks: " . $now->format('Y-m-d H:i:s') . "\n";
?>

Output

Current date/time: 2024-06-01 15:30:00
Date/time after 2 weeks: 2024-06-15 15:30:00

Common Pitfalls

One common mistake is forgetting that DateTime objects are mutable, so modifying one changes it permanently. Another is not handling time zones properly, which can cause unexpected results. Also, passing an invalid date string to the constructor throws an exception.

Always catch exceptions or validate input dates.

php

<?php
// Wrong: modifying original DateTime object unintentionally
$date = new DateTime('2024-06-01');
$modified = $date;
$modified->modify('+1 day');
// Both $date and $modified now show the modified date

// Right: clone before modifying
$date = new DateTime('2024-06-01');
$modified = clone $date;
$modified->modify('+1 day');
// $date remains unchanged
?>

Quick Reference

Method	Description
__construct(string $time = 'now')	Creates a new DateTime object with the given time string or current time.
format(string $format)	Returns the date/time as a formatted string.
modify(string $modifier)	Changes the date/time by adding or subtracting time.
setTimezone(DateTimeZone $timezone)	Sets the time zone for the DateTime object.
diff(DateTime $datetime)	Calculates the difference between two DateTime objects.

Key Takeaways

Create a DateTime object with new DateTime() for current or specific date/time.

Use format() to display dates in any style you want.

Modify dates safely by cloning objects before changing them.

Handle exceptions for invalid date strings to avoid errors.

Use setTimezone() to work correctly with different time zones.