PHP mktime() 함수 – 지정한 시점의 날짜와 시간을 유닉스 타임스탬프로 반환

정의 및 사용 방법

PHP 버전: 4+

mktime() 함수는 지정한 특정 시점의 날짜와 시간을 유닉스 타임스탬프(Unix Timestamp)로 변환하여 정수(int)로 반환합니다.
지정한 특정 시점은 현재 구현되는 PHP 스크립트에 설정된 기본 날짜 시간대(timezone)를 기준으로 합니다.

유닉스 타임스탬프(Unix Timestamp)는 컴퓨터가 시간을 기록하기 위해 사용하는 숫자 형식의 공통 시각 표현 방식으로, 날짜와 시간을 '초(seconds)' 단위로 변환한 정수입니다. 사람이 직접 이 유닉스 타임스탬프 값을 계산하기 어렵기 때문에 PHP에서는 특정 시점의 날짜와 시간을 주로 mktime() 함수를 이용해 유닉스 타임스탬프로 변환해서 활용합니다.

특징

매개변수에 특정 날짜와 시간을 지정하면, 스크립트에서 설정된 기본 날짜 시간대(timezone)를 기준으로 유닉스 타임스탬프(Unix Timestamp)로 변환하여 정수(int)로 반환합니다.
유닉스 타임스탬프만을 반환하기 때문에 시간대(timezone), 요일, 월, 연도 등의 추가 정보는 포함되지 않습니다.

예제

PHP

/**
 * 간단 구문 설명
 *
 * mktime($hour, $minute, $second, $month, $day, $year): int|false
 * @param int $hour (필수): 해당 날짜의 시작 '시'를 기준으로 한 시각
 * @param int $minute, $second, $month, $day, $year (옵션): 지정된 날짜와 시간을 설정
 */

/* 2025년 12월 25일 9시 30분 5초의 타임스탬프 구하기 */
$timestamp = mktime(9, 30, 5, 12, 25, 2025);
echo $timestamp; // 해당 시점의 유닉스 타임스탬프를 정수로 출력

/* mktime() 함수 활용 예제: 읽기 쉬운 날짜/시간으로 변환 */
echo date('Y-m-d H:i:s', $timestamp); // 해당 시점 기준 날짜와 시간을 'YYYY-MM-DD HH:MM:SS' 형식으로 출력

코드 부연설명
date() 함수는 날짜와 시간을 지정한 형식(포맷, Format)에 맞춰서 문자열로 반환합니다.
위 예제 코드에서 사용된 두 번째 매개변수는 옵션이며, 원하는 시간을 지정하는 유닉스 타임스탬프(Unix Timestamp)입니다. 정수(int)로 지정합니다.

추가 팁!
지정한 특정 시점의 날짜와 시간이 아닌,
현재 시점의 날짜와 시간을 유닉스 타임스탬프로 변환하여 정수로 반환하려면 time() 함수를 사용하세요.

추가 팁!
현재 설정된 기본 날짜 시간대를 확인하고 싶다면 date_default_timezone_get() 함수를 사용해 보세요.

구문

주의하세요!
매개변수의 순서가 월, 일, 연도 순으로 되어 있어 일반적인 연도, 월, 일 순서가 아니라는 점에 주의해야 합니다.

매개변수

mktime() 함수의 매개변수 설명
`$hour`	필수(PHP 8.0부터). 24시간제 기준으로 한 지정할 '시'를 정수(int)로 지정합니다. `0`부터 `23`까지의 값이 가능합니다. 예를 들어, `9`는 오전 9시를 의미하고 `21`은 오후 9시를 의미합니다. 음수 값은 해당 날짜의 자정 전 '시'를 나타냅니다. `23`보다 큰 값은 다음 날의 해당 '시'를 나타냅니다.
`$minute`	옵션. 정시 시작 시점을 기준으로 한 '분' 단위 값을 정수(int)로 지정합니다. `0`부터 `59`까지의 값이 가능합니다. 기본값은 `null`이며, 생략하거나 `null`을 전달하면 현재 시점의 '분'이 지정됩니다. 음수 값은 이전 '시'의 '분'을 나타냅니다. `59`보다 큰 값은 다음 '시'의 해당 '분'을 나타냅니다.
`$second`	옵션. 분의 시작 시점을 기준으로 한 '초' 단위 값을 정수(int)로 지정합니다. `0`부터 `59`까지의 값이 가능합니다. 기본값은 `null`이며, 생략하거나 `null`을 전달하면 현재 시점의 '초'가 지정됩니다. 음수 값은 이전 '분'의 '초'를 나타냅니다. `59`보다 큰 값은 다음 '분'의 해당 '초'를 나타냅니다.
`$month`	옵션. 지정할 '월'을 정수(int)로 지정합니다. `1`부터 `12`까지의 값이 가능합니다. '연도'의 첫 '월'은`1`이고 마지막 '월'은 `12`입니다. 기본값은 `null`이며, 생략하거나 `null`을 전달하면 현재 시점의 '월'이 지정됩니다. `1`보다 작은 값(음수 포함)은 전년도의 '월'을 역순으로 나타냅니다. 즉, `0`은 전년도의 12월, `-1`은 전년도의 11월 등입니다. `12`보다 큰 값은 다음 해의 해당 '월'을 나타냅니다.
`$day`	옵션. 지정할 '일'을 정수(int)로 지정합니다. `1`부터 `28`, `29`, `30` 또는 `31`('월'에 따라 다름)까지의 값은 해당 '월'의 일반적인 일수를 나타냅니다. '월'의 첫 '일'은`1`입니다. 기본값은 `null`이며, 생략하거나 `null`을 전달하면 현재 시점의 '일'이 지정됩니다. `1`보다 작은 값(음수 포함)은 전월의 일수를 나타내며, `0`은 전월의 마지막 날, `-1`은 전월의 마지막 날의 그 전날을 의미합니다. 해당 '월'의 일수보다 큰 값은 다음 '월'의 해당 날짜를 나타냅니다.
`$year`	옵션. '연도'를 정수(int)로 지정합니다. '연도'의 수는 두 자리 또는 네 자리 숫자일 수 있으며, 두 자리로 지정할 경우 `00`에서 `69` 값은 `2000`에서 `2069`에 매핑되고 `70`에서 `100`은 `1970`에서 `2000`에 매핑됩니다. 기본값은 `null`이며, 생략하거나 `null`을 전달하면 현재 시점의 '연도'가 지정됩니다. 두 자리 숫자는 헷갈릴 수 있으므로 네 자리 숫자를 지정하면 편리합니다.

반환 값

지정한 특정 시점의 날짜와 시간을 유닉스 타임스탬프(Unix Timestamp)로 변환하여 정수(int)로 반환합니다. 만약 실패하면 false를 반환합니다.

반환되는 유닉스 타임스탬프(Unix Timestamp)

유닉스 타임스탬프(Unix Timestamp)는 1970년 1월 1일 00:00:00 UTC(협정 세계시)를 기준으로 지정한 특정 시점의 날짜와 시간까지 경과한 시간을 초(seconds) 단위로 나타낸 정수입니다.

따라서, 반환되는 값에 특정 시간만큼 초(seconds) 단위로 계산되는 정수를 더하거나 빼서 특정 시점을 기준으로 하는 미래/과거 날짜를 구할 수 있습니다.

PHP

// 2025년 12월 31일 23시 59분의 유닉스 타임스탬프
$timestamp = mktime(23, 59, 0, 12, 31, 2025);
echo $timestamp;  // 출력: 1767235140

// 타임스탬프에서 1일을 더한 날짜 계산(미래 날짜)
$new_timestamp = $timestamp + (60 * 60 * 24);  // 1일(24시간)을 초 단위로 더함
echo date('Y-m-d H:i:s', $new_timestamp);  // 출력: 2026-01-01 23:59:00

// 타임스탬프에서 1일을 뺀 날짜 계산(과거 날짜)
$past_timestamp = $timestamp - (60 * 60 * 24);  // 1일(24시간)을 초 단위로 뺌
echo date('Y-m-d H:i:s', $past_timestamp);  // 출력: 2025-12-30 23:59:00

변경 이력

mktime() 함수의 변경 이력
버전	설명
8.0.0	PHP 8.0.0부터 `$hour`는 더 이상 옵션이 아니라 필수입니다. 지정하지 않으면 `Fatal error`가 발생합니다. 8.0.0 이전에는 `$hour`를 생략하면, 현재 시점의 '시'가 지정되었습니다.
8.0.0	PHP 8.0.0부터 `$minute`, `$second`, `$month`, `$day`, `$year` 매개변수가 이제 nullable하게 변경되었습니다. 이것은 매개변수의 값으로 `null`을 지정할 수 있음을 의미합니다.

활용 예제

mktime() 함수는 특정 날짜를 기준으로 하기 때문에, 특정 이벤트나 기념일 등을 현재 시점에서 계산할 때 특히 유용하게 활용됩니다.

결혼 기념일까지 남은 일수 계산

PHP

// 결혼 기념일: 2027년 5월 20일 (미래 날짜로 설정)
$anniversary_timestamp = mktime(0, 0, 0, 5, 20, 2027);

// 현재 시점의 유닉스 타임스탬프
$current_timestamp = time();

// 기념일까지 남은 초(seconds) 계산
$seconds_until_anniversary = $anniversary_timestamp - $current_timestamp;

// 초를 일수로 변환 (60초 * 60분 * 24시간 = 86400초)
$days_until_anniversary = floor($seconds_until_anniversary / (60 * 60 * 24));

echo "결혼 기념일까지 남은 일수: " . $days_until_anniversary . "일";

코드 부연설명
floor() 함수는 실수를 전달받아 소수점 이하를 무조건 버리고, 그보다 작거나 같은 가장 큰 정수를 반환합니다.
예제에서는 아직 지나지 않은 시간은 제외하고 완전히 경과한 '전체 일수'만 정확히 구하기 위해 사용되었습니다.

PHP 공부를 시작한 지 며칠이나 지났을까?

PHP

/* 활용 예제: PHP 공부를 시작한 지 며칠이나 지났을까? */

// PHP 공부 시작일: 2026년 2월 10일 (자신이 공부를 시작한 날짜를 넣어보세요!)
$start_date = mktime(0, 0, 0, 2, 10, 2026);

// 현재 시점의 유닉스 타임스탬프
$current_time = time();

// 시작일부터 지금까지 흐른 시간(초) 계산
$elapsed_seconds = $current_time - $start_date;

// 초를 일수로 변환
$elapsed_days = floor($elapsed_seconds / (60 * 60 * 24));

echo "PHP 공부를 시작한 지 벌써 " . $elapsed_days . "일이 지났습니다. ";
echo "이 정도면 이제 PHP와 제법 친해지셨나요? 끝까지 함께 가시죠! 화이팅!";