strtotime

    (PHP 4, PHP 5, PHP 7, PHP 8)

    strtotime — Parse about any English textual datetime description into a Unix timestamp

    Опис

    strtotime(string $datetime, ?int $baseTimestamp = null): int|false

    The function expects to be given a string containing an English date format and will try to parse that format into a Unix timestamp (the number of seconds since January 1 1970 00:00:00 UTC), relative to the timestamp given in baseTimestamp, or the current time if baseTimestamp is not supplied. The date string parsing is defined in Date and Time Formats, and has several subtle considerations. Reviewing the full details there is strongly recommended.

    Увага

    The Unix timestamp that this function returns does not contain information about time zones. In order to do calculations with date/time information, you should use the more capable DateTimeImmutable.

    Each parameter of this function uses the default time zone unless a time zone is specified in that parameter. Be careful not to use different time zones in each parameter unless that is intended. See date_default_timezone_get() on the various ways to define the default time zone.

    Параметри

    datetime

    Рядок дати/часу. Пояснення коректних форматів надано в Формати дати й часу.

    baseTimestamp

    The timestamp which is used as a base for the calculation of relative dates.

    Значення, що повертаються

    Returns a timestamp on success, false otherwise.

    Помилки/виключення

    Якщо часовий пояс хибний, то під час кожного виклику функції дати/часу виникатиме E_WARNING. Див. date_default_timezone_set().

    Журнал змін

    Версія Опис
    8.0.0 baseTimestamp is nullable now.

    Приклади

    Приклад #1 A strtotime() example

    <?php
    echo strtotime("now"), "\n";
    echo     strtotime("10 September 2000"), "\n";
    echo     strtotime("+1 day"), "\n";
    echo     strtotime("+1 week"), "\n";
    echo     strtotime("+1 week 2 days 4 hours 2 seconds"), "\n";
    echo     strtotime("next Thursday"), "\n";
    echo     strtotime("last Monday"), "\n";
    ?>

    Приклад #2 Checking for failure

    <?php
    $str     = 'Not Good';

    if ((    $timestamp = strtotime($str)) === false) {
    echo     "The string ($str) is bogus";
    } else {
    echo     "$str == " . date('l dS \o\f F Y h:i:s A', $timestamp);
    }
    ?>

    Примітки

    Зауваження:

    "Relative" date in this case also means that if a particular component of the date/time stamp is not provided, it will be taken verbatim from the baseTimestamp. That is, strtotime('February'), if run on the 31st of May 2022, will be interpreted as 31 February 2022, which will overflow into a timestamp on 3 March. (In a leap year, it would be 2 March.) Using strtotime('1 February') or strtotime('first day of February') would avoid that problem.

    Зауваження:

    If the number of the year is specified in a two digit format, the values between 00-69 are mapped to 2000-2069 and 70-99 to 1970-1999. See the notes below for possible differences on 32bit systems (possible dates might end on 2038-01-19 03:14:07).

    Зауваження:

    The valid range of a timestamp is typically from Fri, 13 Dec 1901 20:45:54 UTC to Tue, 19 Jan 2038 03:14:07 UTC. (These are the dates that correspond to the minimum and maximum values for a 32-bit signed integer.)

    For 64-bit versions of PHP, the valid range of a timestamp is effectively infinite, as 64 bits can represent approximately 293 billion years in either direction.

    Зауваження:

    Using this function for mathematical operations is not advisable. It is better to use DateTime::add() and DateTime::sub().

    Прогляньте також

    Improve This Page

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 4 notes

    up
    10
    Vyacheslav Belchuk
    1 year ago
    Be careful when using two numbers as the year. I came across this situation:

    <?php

    echo strtotime('24.11.22');
    echo     date('d.m.Y H:i:s', 1669324282) . "\n\n";

    // But
    echo strtotime('24.11.2022');
    echo     date('d.m.Y H:i:s', 1669237200);

    ?>

    Output:

    1669324282
    25.11.2022 00:11:22

    1669237200
    24.11.2022 00:00:00
    up
    6
    info at pipasjourney dot com
    1 year ago
    Be aware of this: 1 month before the 31st day, it will return the same month:

    <?php
    echo date('m', strtotime('2023-05-30 -1 month')) ; //returns 04
    echo date('m', strtotime('2023-05-31 -1 month')) ; //returns 05, not 04
    ?>

    So, don't use this to operate on the month of the result.
    A better way to know what month was the previous month would be:

    <?php
    //considering today is 2023-05-31...

    $firstOfThisMonth = date('Y-m') . '-01'; //returns 2023-05-01
    echo date('m', strtotime($firstOfThisMonth . ' -1 month')) ; //returns 04
    ?>
    up
    1
    elsiland at yahoo dot com
    21 days ago
    Not sure why, but
    <?php
    echo strtotime("+2 hours"), "\n";
    echo     strtotime("+2 hrs"), "\n";
    echo     strtotime("+2 hourss"), "\n";
    ?>

    are returning +2 hours, -2 hours, +8 hours. The latter two should be errors instead.
    up
    0
    et dot coder at gmail dot com
    7 months ago
    > The Unix timestamp that this function returns does not contain information about time zones. In order to do calculations with date/time information, you should use the more capable DateTimeImmutable.

    important - does not contain

    <?php
    date_default_timezone_set    ('Europe/Berlin');

    // .... a lot of code

    echo $a = strtotime('yesterday 00:00');

    // in $a hour = 23:00:00 and you may not know about it
    // https://onlinephp.io/c/ef696
    // use DateTimeImmutable
    ＋add a note
    To Top