PHP mktime() Function

PHP

PHP mktime() - Get Unix Timestamp

Author: PHP timestamp specialist with 15+ years of experience

Category: Date | Subcategory: mktime()

Introduction

The mktime() function in PHP is a powerful tool for generating Unix timestamps from date and time components. A Unix timestamp represents the number of seconds elapsed since January 1, 1970, 00:00:00 GMT (the Unix Epoch). Using mktime(), developers can create timestamps that facilitate date calculations, comparisons, and formatting.

In this tutorial, you will learn how to effectively use the mktime() function, understand its parameters, see practical examples, avoid common pitfalls, and prepare for interview questions related to timestamp creation in PHP.

Prerequisites

  • Basic knowledge of PHP programming
  • Understanding of dates and time concepts
  • PHP 5.1.0 or later installed (highly recommended to use recent versions)

Setup

No special setup is required to use mktime() as it is a built-in PHP function. Ensure your PHP development environment is ready and you have access to a command line or web server to run PHP scripts.

Understanding the PHP mktime() Function

mktime() creates a Unix timestamp from specified date and time parameters.

int mktime(
  int $hour,
  int $minute,
  int $second,
  int $month,
  int $day,
  int $year
)

Parameters:

  • $hour — Hour of the time (0 to 23)
  • $minute — Minutes (0 to 59)
  • $second — Seconds (0 to 59)
  • $month — Month (1 to 12)
  • $day — Day of the month (1 to 31)
  • $year — Year (four digits)

The function returns an integer Unix timestamp representing the specified date/time in the server’s default timezone.

Practical Examples

Example 1: Get Timestamp for a Specific Date and Time

<?php
$timestamp = mktime(15, 30, 0, 6, 10, 2024); 
echo "Unix Timestamp for June 10, 2024 15:30:00 is: " . $timestamp;
?>

Output: Unix Timestamp for June 10, 2024 15:30:00 is: 1717977000

Example 2: Convert Timestamp Back to Human-Readable Date

<?php
$timestamp = mktime(0, 0, 0, 1, 1, 2023);
echo "Date: " . date('Y-m-d H:i:s', $timestamp);
?>

Output: Date: 2023-01-01 00:00:00

Example 3: Creating Timestamp for Tomorrow at Noon

<?php
$tomorrow = mktime(12, 0, 0, date('m'), date('d') + 1, date('Y'));
echo "Tomorrow at noon Timestamp: " . $tomorrow;
?>

Example 4: Using mktime() with Negative or Overflow Values

PHP mktime() intelligently adjusts overflow and negative values.

<?php
// 35th day of January is automatically adjusted to February 4
$timestamp = mktime(0, 0, 0, 1, 35, 2024);
echo date('Y-m-d', $timestamp); // Outputs 2024-02-04
?>

Best Practices

  • Always validate date components before passing to mktime() to avoid unexpected results.
  • Be aware of your server’s timezone settings; use date_default_timezone_set() to set the timezone explicitly.
  • Prefer DateTimeImmutable and DateTime objects for complex date/time manipulations in PHP 7.2+ but mktime() remains simple and fast for timestamp creation.
  • Use mktime() when you need timestamps derived from separate date and time components.

Common Mistakes

  • Passing invalid values without validation — for example, month as 0 or day as 32 — can produce unintended dates.
  • Not accounting for timezone differences — remember mktime() uses the default timezone.
  • Confusing mktime() with time() — time() returns the current time, mktime() builds a timestamp from components.
  • Using two-digit years — always pass four-digit years to avoid ambiguity.

Interview Questions

Junior-Level

  • Q1: What does mktime() function return?
    A: It returns an integer Unix timestamp for the specified date and time.
  • Q2: Which parameters are mandatory in mktime()?
    A: All six components (hour, minute, second, month, day, year) need to be provided.
  • Q3: What is the Unix timestamp?
    A: The number of seconds since January 1, 1970, 00:00:00 GMT.
  • Q4: What happens if you pass an invalid day like 32 to mktime()?
    A: The function adjusts the date accordingly, e.g., 32 January becomes 1 February.
  • Q5: How can you print the date from a timestamp created by mktime()?
    A: Use the date() function with the timestamp as the second parameter.

Mid-Level

  • Q1: How does timezone affect the result of mktime()?
    A: The timestamp generated is based on the server’s default timezone setting unless changed by date_default_timezone_set().
  • Q2: How would you create a timestamp for midnight on New Year's Day 2025?
    A: mktime(0, 0, 0, 1, 1, 2025);
  • Q3: Is it possible to use negative numbers in mktime() parameters? What is their effect?
    A: Yes, negative or overflow values adjust the resulting timestamp by subtracting/adding the overflow accordingly.
  • Q4: How do you set the server timezone for consistent timestamp creation?
    A: Use date_default_timezone_set('Timezone/Region'); at script start.
  • Q5: How is mktime() different from strtotime() in PHP?
    A: mktime() takes explicit date/time components, strtotime() parses date/time strings.

Senior-Level

  • Q1: When might you prefer DateTime or DateTimeImmutable over mktime()?
    A: For advanced date/time manipulation, timezone conversions, and immutability, DateTime classes are preferable.
  • Q2: How does mktime() handle leap seconds or daylight saving time changes?
    A: It does not account for leap seconds and relies on system timezone rules for DST adjustments, which may vary.
  • Q3: Explain how mktime() processes parameters when you give an out-of-range hour like 25.
    A: It adds the overflow to the day component. For example, 25 hours means 1 day and 1 hour added.
  • Q4: What are the potential risks of relying solely on mktime() in multi-timezone applications?
    A: Because it uses default timezone, timestamps may be inconsistent across different server settings if timezone isn't explicitly handled.
  • Q5: Describe performance considerations when using mktime() repeatedly in date-intensive applications.
    A: mktime() is lightweight and fast for timestamp creation, but for complex date calculations, DateTime objects might be more efficient and maintainable.

Frequently Asked Questions (FAQ)

Q: What is the difference between mktime() and time()?

A: time() returns the current Unix timestamp, whereas mktime() creates a timestamp from provided hour, minute, second, month, day, and year parameters.

Q: Can mktime() handle timezones?

A: Not directly. It uses the server’s default timezone. To control timezone behavior, set the default timezone explicitly using date_default_timezone_set().

Q: What datatype does mktime() return?

A: It returns an integer representing the Unix timestamp.

Q: Why would mktime() return false?

A: In rare cases, if the date/time is invalid or out of the valid range for your system, mktime() may return false.

Q: Is mktime() deprecated?

A: No, it is still widely used and supported in PHP versions, though newer APIs like DateTime are recommended for complex usage.

Conclusion

The PHP mktime() function is essential for creating Unix timestamps from date and time components, enabling efficient timestamp generation and calculations. Whether you need to compute future dates, convert dates to timestamps, or handle overflow dates, mktime() is a quick and reliable choice.

Understanding the function’s parameters, behavior with value overflows, and timezone influence will help you avoid common mistakes and leverage mktime() effectively in your PHP projects.

For more complex date handling, consider PHP’s DateTime classes, but always keep mktime() in your toolkit for straightforward timestamp creation needs.