date() ב-PHP: קבלת תאריכים, עיצוב וחישוב

date('Y-m-d') מחזירה את התאריך של היום כמחרוזת, כמו 2026-03-14. הארגומנט הראשון הוא מחרוזת פורמט שבה כל אות מייצגת חלק מהתאריך (Y השנה, m החודש, d היום, H:i:s השעה), וארגומנט שני אופציונלי הוא חותמת זמן Unix לעיצוב במקום הרגע הנוכחי.

<?php
echo date('Y-m-d'), "\n";          // today's date
echo date('H:i:s'), "\n";          // current time, 24-hour clock
echo date('Y-m-d H:i:s'), "\n";    // both, the format databases use
echo date('l, F jS, Y'), "\n";     // long form, e.g. Saturday, March 14th, 2026
echo time(), "\n";                 // seconds since 1970-01-01 00:00:00 UTC

הפלט משתנה בכל פעם שלוחצים על Run, כי זה התאריך והשעה הנוכחיים ב-UTC. כל אות של מחרוזת הפורמט, ואיך שמים טקסט רגיל ביניהן, נמצאות בעמוד פורמט תאריך ב-PHP.

חותמות זמן: time(), mktime() ו-strtotime()

חותמת זמן Unix היא מספר השניות מאז 1 בינואר 1970 בחצות UTC. time() מחזירה את הנוכחית, mktime(hour, minute, second, month, day, year) בונה אחת מחלקים, ו-strtotime() קוראת תאריך שכתוב באנגלית ('2026-03-14', '+1 week', 'next monday'). העבירו כל חותמת זמן כארגומנט השני של date(). הארגומנט השני של strtotime() הוא הרגע שממנו נספר ביטוי יחסי; בלעדיו, הוא נספר מעכשיו.

<?php
$ts = mktime(9, 30, 0, 3, 14, 2026);   // 2026-03-14 09:30:00
echo $ts, "\n";
echo date('D, d M Y H:i', $ts), "\n";

// mktime() rolls over: month 13 of 2026 is January 2027
echo date('Y-m-d', mktime(0, 0, 0, 13, 1, 2026)), "\n\n";

$phrases = ['tomorrow', '+1 week', 'next monday', 'last day of this month', 'first monday of next month'];
foreach ($phrases as $phrase) {
    echo str_pad($phrase, 28), date('D Y-m-d', strtotime($phrase, $ts)), "\n";
}

var_dump(strtotime('not a date'));   // false: check before you use it

פלט:

1773480600
Sat, 14 Mar 2026 09:30
2027-01-01

tomorrow                    Sun 2026-03-15
+1 week                     Sat 2026-03-21
next monday                 Mon 2026-03-16
last day of this month      Tue 2026-03-31
first monday of next month  Mon 2026-04-06
bool(false)

הגלגול ב-mktime() שימושי: יום 0 של חודש הוא היום האחרון של החודש הקודם, ולכן mktime(0, 0, 0, 3, 0, 2026) הוא 28 בפברואר. תמיד השוו את התוצאה ל-false לפני שאתם מעבירים אותה הלאה: date('Y-m-d', false) מדפיסה בשקט 1970-01-01, תאריך שאף אחד לא התכוון אליו.

הוספת ימים לתאריך

לכל דבר מעבר להדפסה, השתמשו ב-DateTimeImmutable. המתודה modify() שלה מקבלת את אותם ביטויים כמו strtotime() ומחזירה תאריך חדש, ו-add() מקבלת DateInterval כמו P7D (תקופה של 7 ימים) או PT90M (90 דקות).

<?php
$date = new DateTimeImmutable('2026-03-14 09:30');

echo $date->modify('+7 days')->format('Y-m-d'), "\n";
echo $date->modify('-1 day')->format('Y-m-d'), "\n";
echo $date->add(new DateInterval('P1M'))->format('Y-m-d'), "\n";
echo $date->add(new DateInterval('PT90M'))->format('H:i'), "\n";
echo $date->sub(new DateInterval('P1Y'))->format('Y-m-d'), "\n";

// Adding a month to January 31 overflows into March
$jan31 = new DateTimeImmutable('2026-01-31');
echo $jan31->modify('+1 month')->format('Y-m-d'), "\n";
echo $jan31->modify('last day of next month')->format('Y-m-d'), "\n";

פלט:

2026-03-21
2026-03-13
2026-04-14
11:00
2025-03-14
2026-03-03
2026-02-28

31 בפברואר לא קיים, ולכן +1 month על 31 בינואר נוחת ב-3 במרץ. כשאתם מתכוונים ל"סוף החודש הבא", אמרו את זה עם last day of next month.

DateTime מול DateTimeImmutable

DateTime משנה את עצמה כשקוראים ל-modify(), ל-add() או ל-setDate(), ומחזירה את אותו אובייקט. זה מפתיע אנשים ששומרים את התאריך המקורי במשתנה:

<?php
$start = new DateTime('2026-03-14');
$end = $start->modify('+7 days');

echo $start->format('Y-m-d'), "\n";   // the start moved too
echo $end->format('Y-m-d'), "\n";
var_dump($start === $end);            // the same object

$start = new DateTimeImmutable('2026-03-14');
$end = $start->modify('+7 days');

echo $start->format('Y-m-d'), "\n";   // unchanged
echo $end->format('Y-m-d'), "\n";

פלט:

2026-03-21
2026-03-21
bool(true)
2026-03-14
2026-03-21

העדיפו את DateTimeImmutable בקוד חדש. לשתי המחלקות יש אותן מתודות ושתיהן מממשות את DateTimeInterface, ולכן פונקציה יכולה לקבל כל אחת מהן.

ההפרש בין שני תאריכים

diff() מחזירה DateInterval. המאפיין days שלה הוא מספר הימים הכולל בין שני התאריכים, בעוד y, m ו-d מפצלים את הפער לשנים, חודשים וימים, וזה בדיוק מה שחישוב גיל צריך. שנו את התאריכים והריצו שוב:

<?php
$birthday = new DateTimeImmutable('1990-07-20');
$today = new DateTimeImmutable('2026-03-14');

$age = $birthday->diff($today);
echo "Age: {$age->y}\n";
echo "Exactly: {$age->y} years, {$age->m} months, {$age->d} days\n";
echo "Days alive: {$age->days}\n";

$christmas = new DateTimeImmutable('2026-12-25');
$wait = $today->diff($christmas);
echo $wait->days, " days to go\n";
echo $wait->format('%m months and %d days'), "\n";

// Reversed order: invert is 1 and %R prints the sign
echo $christmas->diff($today)->format('%R%a days'), "\n";

פלט:

Age: 35
Exactly: 35 years, 7 months, 22 days
Days alive: 13021
286 days to go
9 months and 11 days
-286 days

ב-format(), %a הוא מספר הימים הכולל ו-%d הוא רק חלק הימים, ולכן %a הוא זה שמשתמשים בו ל"ימים עד". כדי להשוות שני תאריכים בלי הפרש, האופרטורים הרגילים עובדים על אובייקטי תאריך: $today < $christmas הוא true.

אזורי זמן

date() ו-new DateTimeImmutable() משתמשות באזור הזמן של ברירת המחדל, שמגיע מ-date.timezone ב-php.ini (UTC כשהוא לא מוגדר). הגדירו אותו לכל הסקריפט עם date_default_timezone_set(), או תנו לתאריך בודד DateTimeZone משלו והמירו עם setTimezone():

<?php
$meeting = new DateTimeImmutable('2026-03-14 09:30', new DateTimeZone('UTC'));

foreach (['Asia/Tokyo', 'Europe/Berlin', 'America/New_York'] as $zone) {
    $local = $meeting->setTimezone(new DateTimeZone($zone));
    echo str_pad($zone, 18), $local->format('Y-m-d H:i T P'), "\n";
}

date_default_timezone_set('Asia/Tokyo');
echo date_default_timezone_get(), "\n";
echo date('Y-m-d H:i', $meeting->getTimestamp()), "\n";

פלט:

Asia/Tokyo        2026-03-14 18:30 JST +09:00
Europe/Berlin     2026-03-14 10:30 CET +01:00
America/New_York  2026-03-14 05:30 EDT -04:00
Asia/Tokyo
2026-03-14 18:30

חותמת זמן היא אותו מספר בכל מקום; אזור הזמן רק משנה את האופן שבו היא נכתבת. לכן העצה הרגילה היא לשמור תאריכים ב-UTC ולהמיר כשמציגים אותם.

הצגת לוח שנה בדף אינטרנט

תאריכים מודפסים בדרך כלל לתוך HTML. הבלוק הזה מצייר את החודש הנוכחי כלוח שנה ומדגיש את היום. הריצו אותו, ואז לחצו על Previous או Next: אותו סקריפט ירוץ שוב כש-$_GET['m'] מוגדר מהקישור, כמו ?m=2026-04.

<?php
$month = $_GET['m'] ?? date('Y-m');
$first = DateTimeImmutable::createFromFormat('!Y-m', $month)
    ?: new DateTimeImmutable('first day of this month midnight');

$prev = $first->modify('-1 month')->format('Y-m');
$next = $first->modify('+1 month')->format('Y-m');
$today = date('Y-m-d');
$days = (int) $first->format('t');   // days in this month
?>
<style>
    th, td { width: 2.4em; padding: 4px; text-align: center; }
    .today { background: #ffd54f; border-radius: 4px; }
</style>
<h3><?= $first->format('F Y') ?></h3>
<p><a href="?m=<?= $prev ?>">Previous</a> | <a href="?m=<?= $next ?>">Next</a></p>
<table>
    <tr><th>Mon</th><th>Tue</th><th>Wed</th><th>Thu</th><th>Fri</th><th>Sat</th><th>Sun</th></tr>
    <tr>
<?php
echo str_repeat('<td></td>', (int) $first->format('N') - 1);
for ($day = 1; $day <= $days; $day++) {
    $date = $first->modify('+' . ($day - 1) . ' days');
    $class = $date->format('Y-m-d') === $today ? ' class="today"' : '';
    echo "<td$class>$day</td>";
    if ($date->format('N') === '7' && $day < $days) {
        echo "</tr>\n<tr>";
    }
}
?>
    </tr>
</table>

format('N') נותן את היום בשבוע כ-1 (שני) עד 7 (ראשון), וזה מספר התאים הריקים שבאים לפני ה-1 בחודש, ו-format('t') נותן את מספר הימים בחודש. ה-! ב-'!Y-m' מאפס כל שדה שהפורמט לא מזכיר, ולכן היום הוא ה-1 והשעה היא חצות.

טעויות נפוצות עם date()

הארגומנט השני של date() חייב להיות חותמת זמן, לא מחרוזת תאריך. השורה הזו:

<?php
echo date('d/m/Y', '2026-03-14');

עוצרת את הסקריפט עם TypeError:

PHP Fatal error:  Uncaught TypeError: date(): Argument #2 ($timestamp) must be of type ?int, string given in /home/index.php:2

המירו קודם את המחרוזת, עם strtotime() או עם אובייקט:

<?php
$input = '2026-03-14';

echo date('d/m/Y', strtotime($input)), "\n";
echo (new DateTimeImmutable($input))->format('d/m/Y'), "\n";

// Check that a date really exists before using it
var_dump(checkdate(2, 29, 2026));   // 2026 is not a leap year
var_dump(checkdate(2, 29, 2028));

פלט:

14/03/2026
14/03/2026
bool(false)
bool(true)

עוד שתיים שכדאי לשים לב אליהן: m הוא החודש ו-i הן הדקות, ולכן 'H:m' מדפיס את החודש במקום שרציתם דקות; ו-new DateTimeImmutable('garbage') זורק חריגה במקום להחזיר false, אז עטפו קלט משתמש ב-try/catch או פענחו אותו עם DateTimeImmutable::createFromFormat(), שמחזירה false כשאין התאמה.