getdate

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

getdate — Recupera informações de data/hora

Descrição

getdate(?int $timestamp = null): array

Retorna um array associativo contendo a informação da data do timestamp, ou o horário atual local se timestamp for null ou omitido.

Parâmetros

timestamp: O parâmetro opcional timestamp é um int de timestamp Unix cujo padrão é a hora local atual se timestamp não for informado ou for null. Em outras palavras, o padrão é o valor de time().

Valor Retornado

Retorna um array associativo de informação sobre o timestamp. Os elementos do array associativo são os seguintes:

**Elementos chave de retorno do array associativo**
Chave	Descrição	Exemplo dos valores retornados
`"seconds"`	Representação numérica dos segundos	`0` a `59`
`"minutes"`	Representação numérica dos minutos	`0` a `59`
`"hours"`	Representação numérica das horas	`0` a `23`
`"mday"`	Representação numérica do dia do mês	`1` a `31`
`"wday"`	Representação numérica do dia da semana	`0` (para Sunday) a `6` (para Saturday)
`"mon"`	Representação numérica de um mês	`1` a `12`
`"year"`	Representação numérica completa do ano, 4 dígitos	Exemplos: `1999` ou `2003`
`"yday"`	Representação numérica do dia do ano	`0` a `365`
`"weekday"`	Representação textual completa do dia da semana	`Sunday` a `Saturday`
`"month"`	Representação textual completa de um mês, tal como January ou March	`January` a `December`
`0`	Segundos desde a época UNIX, similar ao valor retornados pela função time() e utilizado pela função date().	Dependente do sistema, tipicamente `-2147483648` à `2147483647`.

Registro de Alterações

Versão	Descrição
8.0.0	`timestamp` agora pode ser nulo.

Exemplos

Exemplo #1 Exemplo da função getdate()

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

O exemplo acima produzirá algo semelhante a:

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

Veja Também

date() - Formatar um timestamp Unix
idate() - Formata uma parte de uma hora/data local como um inteiro
localtime() - Obtém o horário local
time() - Retorna o timestamp Unix atual
setlocale() - Set locale information

add a note

User Contributed Notes 6 notes

down

vimal866 at gmail dot com ¶

9 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'];

down

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"; 
?>

down

-13

andre at anlex dot co dot za ¶

18 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..

down

-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/

down

-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]

down

-82

eric dot schultz at NOSPAM dot CyVon dot com ¶

16 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