PHP Date/Timezone Pitfalls

Also Known As

TL;DR

Explanation

PHP date pitfalls: date_default_timezone_set() is process-wide — changing it affects all date operations globally. DateTime is mutable (use DateTimeImmutable). strtotime() is locale-dependent and silently returns false for invalid strings. Comparing DateTime across timezones: two DateTime objects representing the same instant but different timezones compare as unequal by value. Carbon wraps DateTimeImmutable with testing support (Carbon::setTestNow()). Always: store UTC, display in user's timezone, use DateTimeImmutable, validate date strings explicitly.

Common Misconception

Why It Matters

Common Mistakes

• Calling date_default_timezone_set() in library code — it is a global setting; libraries must never change it.
• DateTime instead of DateTimeImmutable — mutation surprises when DateTime is passed to functions.
• Comparing DateTime objects with == — compares string representation not the same instant.
• strtotime() without checking for false — invalid strings return false which converts to timestamp 0 (1970).

Code Examples

// Mutable DateTime — surprise mutation:
$start = new DateTime('2026-01-01');
$end   = $start->modify('+1 month'); // $start is also modified!
echo $start->format('Y-m-d'); // 2026-02-01 — not 2026-01-01!

// Timezone comparison bug:
$utc = new DateTime('12:00', new DateTimeZone('UTC'));
$bst = new DateTime('13:00', new DateTimeZone('Europe/London')); // Same instant
var_dump($utc == $bst); // false — same instant, different representation

// DateTimeImmutable — safe:
$start = new DateTimeImmutable('2026-01-01');
$end   = $start->modify('+1 month'); // $start unchanged
echo $start->format('Y-m-d'); // 2026-01-01 — correct

// Correct comparison — convert to same timezone or compare timestamps:
$utc = new DateTimeImmutable('12:00', new DateTimeZone('UTC'));
$bst = new DateTimeImmutable('13:00', new DateTimeZone('Europe/London'));
var_dump($utc->getTimestamp() === $bst->getTimestamp()); // true

// Validate before using strtotime:
$ts = strtotime($userInput);
if ($ts === false) throw new InvalidArgumentException('Invalid date');

References

• ↗ https://www.php.net/manual/en/class.datetimeimmutable.php

Tags

Related Terms