PHP Manual
Prev |  | Next

# mktime

mktime -- get UNIX timestamp for a date

## Description

`int mktime`(int hour, int minute, int second, int month, int day, int year, int [is_dst]);

Warning: Note the strange order of arguments, which differs from the order of arguments in a regular UNIX mktime() call and which does not lend itself well to leaving out parameters from right to left (see below). It is a common error to mix these values up in a script.

Returns the Unix timestamp corresponding to the arguments given. This timestamp is a long integer containing the number of seconds between the Unix Epoch (January 1 1970) and the time specified.

Arguments may be left out in order from right to left; any arguments thus omitted will be set to the current value according to the local date and time.

`is_dst` can be set to 1 if the time is during daylight savings time, 0 if it is not, or -1 (the default) if it is unknown whether the time is within daylight savings time or not.

> Note: `is_dst` was added in 3.0.10.

mktime() is useful for doing date arithmetic and validation, as it will automatically calculate the correct value for out-of-range input. For example, each of the following lines produces the string "Jan-01-1998".

Example 1. mktime() example
    echo date( "M-d-Y", mktime(0,0,0,12,32,1997) );
    echo date( "M-d-Y", mktime(0,0,0,13,1,1997) );
    echo date( "M-d-Y", mktime(0,0,0,1,1,1998) );

See also date() and time().

Prev | Home | Next
microtime | Up | strftime