PHP 날짜 date(): 현재 날짜, 포맷, 날짜 계산

date('Y-m-d')는 2026-03-14처럼 오늘 날짜를 문자열로 반환합니다. 첫 번째 인수는 각 문자가 날짜의 한 부분을 나타내는 포맷 문자열이고(Y는 연도, m은 월, d는 일, H:i:s는 시간), 선택적인 두 번째 인수는 현재 시각 대신 포맷할 유닉스 타임스탬프입니다.

<?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

UTC 기준의 현재 날짜와 시간이므로 Run을 누를 때마다 출력이 바뀝니다. 포맷 문자열의 모든 문자와 그 사이에 일반 텍스트를 넣는 방법은 PHP 날짜 포맷 페이지에 있습니다.

타임스탬프: time(), mktime(), strtotime()

유닉스 타임스탬프는 1970년 1월 1일 자정 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)은 2월 28일입니다. 결과를 넘기기 전에 항상 false와 비교하세요. date('Y-m-d', false)는 아무도 의도하지 않은 날짜 1970-01-01을 조용히 출력합니다.

날짜에 일수 더하기

출력 이상의 작업에는 DateTimeImmutable을 쓰세요. 그 modify() 메서드는 strtotime()과 같은 표현을 받고 새 날짜를 반환하며, add()는 P7D(7일 기간)나 PT90M(90분) 같은 DateInterval을 받습니다.

<?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

2월 31일은 존재하지 않으므로 1월 31일에 +1 month를 하면 3월 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()은 php.ini의 date.timezone에서 오는 기본 시간대를 씁니다(설정되지 않으면 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를 클릭하세요. 링크에서 ?m=2026-04처럼 설정된 $_GET['m']으로 같은 스크립트가 다시 실행됩니다.

<?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로 감싸거나, 형식이 맞지 않으면 false를 반환하는 DateTimeImmutable::createFromFormat()으로 파싱하세요.