Edit Report a Bug

    gmstrftime

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

    gmstrftime — Format a GMT/UTC time/date according to locale settings

    Warning

    This function has been DEPRECATED as of PHP 8.1.0. Relying on this function is highly discouraged.

    Alternatives to this function include:

    Description

    gmstrftime(string $format, ?int $timestamp = null): string|false

    Behaves the same as strftime() except that the time returned is Greenwich Mean Time (GMT). For example, when run in Eastern Standard Time (GMT -0500), the first line below prints "Dec 31 1998 20:00:00", while the second prints "Jan 01 1999 01:00:00".

    Warning

    This function depends on operating system locale information, which might be inconsistent with each other, or not available at all. Instead use the IntlDateFormatter::format() method.

    Parameters

    format

    See description in strftime().

    timestamp

    The optional timestamp parameter is an int Unix timestamp that defaults to the current local time if timestamp is omitted or null. In other words, it defaults to the value of time().

    Return Values

    Returns a string formatted according to the given format string using the given timestamp or the current local time if no timestamp is given. Month and weekday names and other language dependent strings respect the current locale set with setlocale(). On failure, false is returned.

    Changelog

    Version Description
    8.0.0 timestamp is nullable now.

    Examples

    Example #1 gmstrftime() example

    <?php
    setlocale    (LC_TIME, 'en_US');
    echo     strftime("%b %d %Y %H:%M:%S", mktime(20, 0, 0, 12, 31, 98)) . "\n";
    echo     gmstrftime("%b %d %Y %H:%M:%S", mktime(20, 0, 0, 12, 31, 98)) . "\n";
    ?>

    See Also

    add a note add a note

    User Contributed Notes 4 notes

    up
    0
    yellow dot snow at huskies dot com
    20 years ago
    HTTP 1.1 (RFC 2068) requires an RFC 1123 date with a four digit year, so the correct format to use for a Last-modified header would look something like this:

    <?php
    header    ("Last-modified: " .
    gmstrftime("%a, %d %b %Y %T %Z",getlastmod()));
    ?>
    up
    -1
    pvdster at hotmail dot com
    19 years ago
    If you want the dutch time on your pages and you are hosted on a server in the USA you can easily change it this way:

    <?php
    setlocale    (LC_TIME, 'nl_NL');
    $tgl = gmstrftime("%d %B %Y - %H:%M uur",time()+3600);
    ?>

    Then use $tgl to display the right time.
    Note the +3600 is a day light savings time correction.
    The result: 22 maart 2005 - 16:39 uur

    First I used the normal date function and this was the previous result: March 22, 2005 - 04:28 AM

    I needed it for a dutch guestbook.

    I'm new to PHP and it took me a while to find it out and maybe it's of no use for experienced PHP programmers but I thought people can always ignore my post :)
    up
    -1
    peter dot albertsson at spray dot se
    19 years ago
    gmstrftime() should not be used to generate a RFC 850 date for use in HTTP headers, since its output is affected by setlocale().

    Use gmdate instead:

    gmdate('D, d M Y H:i:s') . ' GMT';
    up
    -2
    neo at gothic-chat d0t de
    20 years ago
    To get a RFC 850 date (used in HTTP) of the current time:

    gmstrftime ("%A %d-%b-%y %T %Z", time ());

    This will get for example:
    Friday 25-Jun-04 03:30:23 GMT

    Please note that times in HTTP-headers _must_ be GMT, so use gmstrftime() instead of strftime().
    add a note add a note
    To Top