Edit Report a Bug

    getdate

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

    getdate — Get date/time information

    Description

    getdate(?int $timestamp = null): array

    Returns an associative array containing the date information of the timestamp, or the current local time if timestamp is omitted or null.

    Parameters

    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 an associative array of information related to the timestamp. Elements from the returned associative array are as follows:

    Key elements of the returned associative array
    Key Description Example returned values
    "seconds" Numeric representation of seconds 0 to 59
    "minutes" Numeric representation of minutes 0 to 59
    "hours" Numeric representation of hours 0 to 23
    "mday" Numeric representation of the day of the month 1 to 31
    "wday" Numeric representation of the day of the week 0 (for Sunday) through 6 (for Saturday)
    "mon" Numeric representation of a month 1 through 12
    "year" A full numeric representation of a year, 4 digits Examples: 1999 or 2003
    "yday" Numeric representation of the day of the year 0 through 365
    "weekday" A full textual representation of the day of the week Sunday through Saturday
    "month" A full textual representation of a month, such as January or March January through December
    0 Seconds since the Unix Epoch, similar to the values returned by time() and used by date(). System Dependent, typically -2147483648 through 2147483647.

    Changelog

    Version Description
    8.0.0 timestamp is nullable now.

    Examples

    Example #1 getdate() example

    <?php
    $today     = getdate();
    print_r($today);
    ?>

    The above example will output something similar to:

    Array
(
    [seconds] => 40
    [minutes] => 58
    [hours]   => 21
    [mday]    => 17
    [wday]    => 2
    [mon]     => 6
    [year]    => 2003
    [yday]    => 167
    [weekday] => Tuesday
    [month]   => June
    [0]       => 1055901520
)

    See Also

    add a note add a note

    User Contributed Notes 6 notes

    up
    33
    vimal866 at gmail dot com
    8 years ago
    Andre's code will throw an error. for the following line
       
         $d = $todayh[mday];
         $m = $todayh[mon];
         $y = $todayh[year];

    "Notice : Undefined constant mday ,mon,year"

    As is, it was looking for constants called mday, mon, year etc. When it doesn't find such a constant, PHP interprets it as a string.

    like any other request it should be wrapped in quotes like this

         $d = $todayh['mday'];
         $m = $todayh['mon'];
         $y = $todayh['year'];
    up
    19
    Yura Pylypenko (plyrvt at mail dot ru)
    21 years ago
    In addition to canby23 at ms19 post:
    It's a very bad idea to consider day having 24 hours (86400 secs), because some days have 23, some - 25 hours due to daylight saving changes. Using of mkdate() and strtotime() is always preferred. strtotime() also has a very nice behaviour of datetime manipulations:
    <?php
    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";
    ?>
    up
    -13
    andre at anlex dot co dot za
    17 years ago
    I thought best to show a posseble way to go about bypassing the end month issue where the first day in a new month will have the monday of the week that it falls in - in the old month. Use the numbering of days as the constant and work you way from there.

    Example:
    <?php
    //-----------------------------
    $now = time();
    $num = date("w");
    if (    $num == 0)
    {     $sub = 6; }
    else {     $sub = ($num-1); }
    $WeekMon  = mktime(0, 0, 0, date("m", $now)  , date("d", $now)-$sub, date("Y", $now));    //monday week begin calculation
    $todayh = getdate($WeekMon); //monday week begin reconvert

    $d = $todayh[mday];
    $m = $todayh[mon];
    $y = $todayh[year];
    echo     "$d-$m-$y"; //getdate converted day

    ?>

    Allot less code makes everyone happy..
    up
    -8
    info at ajawbk dot com
    6 years ago
    another gmgetdate that is a little faster/suscint (no loops).

    <?php
    function gmgetdate2($ts = null){
                $k = array('seconds','minutes','hours','mday',
                        'wday','mon','year','yday','weekday','month',0);
            return(    array_combine($k,split(":",
                        gmdate('s:i:G:j:w:n:Y:z:l:F:U',is_null($ts)?time():$ts))));
            }
    ?>

    https://ajawbk.com/
    up
    -74
    timforte at gmail dot com
    16 years ago
    It's worth noting that this is local time, not UTC/GMT - gmgetdate doesn't exist :(.

    The most logical way to handle date arithmetic without hitting DST problems is to work in UTC...

    <?php
    function add_days($my_date,$numdays) {
          $date_t = strtotime($my_date.' UTC');
      return     gmdate('Y-m-d',$date_t + ($numdays*86400));
    }
    ?>

    [it's even faster if you use gmmktime instead of strtotime]
    up
    -82
    eric dot schultz at NOSPAM dot CyVon dot com
    15 years ago
    Here is another gmgetdate that is a little faster/suscint (no loops).

    <?php
    function gmgetdate2($ts = null){
                $k = array('seconds','minutes','hours','mday',
                        'wday','mon','year','yday','weekday','month',0);
            return(    array_combine($k,split(":",
                        gmdate('s:i:G:j:w:n:Y:z:l:F:U',is_null($ts)?time():$ts))));
            }
    ?>

    It also returns the values in the same order as getdate.
    add a note add a note
    To Top