Função PHP Date() e Time: Como obter o carimbo de data e hora atual?

Função PHP date ()

A função de data do PHP é uma função integrada que simplifica o trabalho com tipos de dados de data. A função de data do PHP é usada para formatar uma data ou hora em um formato legível por humanos. Pode ser usado para exibir a data de publicação do artigo. registrar os últimos dados atualizados em um banco de dados.

Sintaxe e exemplo de data PHP

PHP Date a seguinte sintaxe básica

<?php
date(format,[timestamp]);
?>

AQUI,

  • “date(…)” é a função que retorna o timestamp atual em PHP no servidor.
  • “formato” é o formato geral que queremos que nossa saída seja, ou seja;
    • “Ymd” para formato de data PHP AAAA-MM-DD
    • “Y” para exibir o ano atual
    • “[timestamp]” é opcional. Se nenhum carimbo de data e hora for fornecido, o PHP obterá a data e hora atual do PHP no servidor.

Vejamos um exemplo básico que exibe o ano atual.

<?php

echo date("Y");

?>

Saída:

2018

O que é um carimbo de data/hora?

Um carimbo de data / hora em PHP é um valor numérico em segundos entre a hora atual e o valor 1st Janeiro de 1970 00:00:00 Horário de Greenwich (GMT).

O valor retornado pela função time depende do fuso horário padrão.

O fuso horário padrão é definido no arquivo php.ini.

Também pode ser definido programaticamente usando a função date_default_timezone_set.

O código abaixo exibe o carimbo de data/hora atual

<?php

echo time();

?>

Supondo que você salvou o arquivo timestamp.php na pasta phptuts, navegue até a URL http://localhost/phptuts/timestamp.php

TimeStamp,

Nota: o valor do timestamp PHP não é uma constante. Isso muda a cada segundo.

Obtendo uma lista de identificadores de fuso horário disponíveis

Antes de vermos como definir o fuso horário padrão de forma programática, vamos ver como obter uma lista de fusos horários suportados.

<?php

$timezone_identifiers = DateTimeZone::listIdentifiers();

foreach($timezone_identifiers as $key => $list){

echo $list . "<br/>";

}
?>

AQUI,

  • “$timezone_identifiers = DateTimeZone::listIdentifiers();” chama o método estático listIdentifiers da classe DateandTime Zone incorporada. O método listIdentifiers retorna uma lista de constantes que são atribuídas à variável $timezone_identifiers.
  • “foreach{…}” itera pelo array numérico e imprime os valores.

Supondo que você salvou o arquivo list_time_zones.php na pasta phptuts, navegue até o URL http://localhost/phptuts/list_time_zones.php

Identificadores de fuso horário

PHP definir fuso horário programaticamente

A função date_default_timezone_set permite definir o fuso horário padrão a partir de um script PHP.

O fuso horário definido será então usado por todas as datas em Scripts de funções PHP. Possui a seguinte sintaxe.

<?php
date_default_timezone_set (string $timezone_identifier);
?>

AQUI,

  • “date_default_timezone_set()” é a função que define o fuso horário padrão
  • “string $timezone_identifier” é o identificador do fuso horário

O script abaixo exibe a hora de acordo com o fuso horário padrão definido no php.ini.

Em seguida, ele altera o fuso horário padrão para Ásia/Calcutá e exibe a hora novamente.

<?php
echo "The time in " . date_default_timezone_get() . " is " . date("H:i:s");

date_default_timezone_set("Asia/Calcutta");
echo "The time in " . date_default_timezone_get() . " is " . date("H:i:s");
?>

Supondo que você salvou o arquivo set_time_zone.php na pasta phptuts, navegue até o URL http://localhost/phptuts/set_time_zone.php

PHP definir fuso horário programaticamente

Função PHP Mktime

A função mktime retorna o carimbo de data/hora em um Unix formato.

Possui a seguinte sintaxe.

<?php
mktime(hour, minute, second, month, day, year, is_dst);
?>

AQUI,

  • “mktime(…)” é a função make PHP timestamp
  • “hora” é opcional, é o número de horas
  • “minuto” é opcional, é o número de minutos
  • “segundo” é opcional, é o número de segundos
  • “mês” é opcional, é o número do mês
  • “dia” é opcional, é o número do dia
  • “ano” é opcional, é o número do ano
  • “is_dst” é opcional, é usado para determinar o horário de verão (DST). 1 é para horário de verão, 0 se não for e -1 se for desconhecido.

Vejamos agora um exemplo que cria um carimbo de data/hora para a data 13/10/2025 usando a função mktime.

<?php

echo mktime(0,0,0,10,13,2025);

?>

AQUI,

  • “0,0,0” é a hora, minuto e segundos, respectivamente.
  • “13” é o dia do mês
  • “10” é o mês do ano
  • “2025” é o ano

Saída:

1760328000

Referência da função PHP Date

A tabela abaixo mostra os parâmetros comuns usados ​​ao trabalhar com as funções de data do PHP.

Parâmetros de tempo PHP

Parâmetro Descrição Exemplo
"R" Retorna a data e hora completas
<?php
echo date("r");
?>
“um”, “A” Retorna se a hora atual é am ou pm, AM ou PM respectivamente
<?php
echo date("a");
echo date("A");
?>
“g”,”G” Retorna a hora sem zeros à esquerda [1 a 12], [0 a 23] respectivamente
<?php
echo date("g"); 
echo date("G");
?>
“h”, “H” Retorna a hora com zeros à esquerda [01 a 12],[00 a 23] respectivamente
<?php
echo date("h"); 
echo date("H");
?>
"é" Retorna os minutos/segundos com zeros à esquerda [00 a 59]
<?php
echo date("i"); 
echo date("s");
?>

Parâmetros do dia

Parâmetro Descrição Exemplo
“D” Retorna o dia do mês com zeros à esquerda [01 a 31]
<?php
echo date("d");
?>
"j" Retorna o dia do mês sem zeros à esquerda [1 a 31]
<?php
echo date("j");
?>
"D" Retorna as 3 primeiras letras do nome do dia [Sub to Sat]
<?php
echo date("D");
?>
"EU" Retorna o nome do dia da semana [Domingo a Sábado]
<?php
echo date("l");
?>
"C" Retorna o dia da semana sem zeros à esquerda [0 a 6] Domingo é representado por zero (0) até sábado representado por seis (6)
<?php
echo date("w");
?>
"Z" Retorna o dia do ano sem espaços iniciais [0 a 365]
<?php
echo date("z");
?>

Parâmetros do mês

Parâmetro Descrição Exemplo
"M" Retorna o número do mês com zeros à esquerda [01 a 12]
<?php
echo date("m");
?>
“N” Retorna o número do mês sem zeros à esquerda [01 a 12]
<?php
echo date("n");
?>
"M" Retorna as 3 primeiras letras do nome do mês [janeiro a dezembro]
<?php
echo date("M");
?>
"F" Retorna o nome do mês [janeiro a dezembro]
<?php
echo date("F");
?>
“T” Retorna o número de dias em um mês [28 a 31]
<?php
echo date("t");
?>

Parâmetros do ano

Parâmetro Descrição Exemplo
"L" Retorna 1 se for ano bissexto e 0 se não for bissexto
<?php
echo date("L");
?>
"Y" Retorna formato de ano com quatro dígitos
<?php
echo date("Y");
?>
“Y” Retorna formato de ano de dois (2) dígitos (00 a 99)
<?php
echo date("y");
?>

Resumo

  • A função de data em PHP é usada para formatar o carimbo de data/hora em um formato desejado pelo homem.
  • O timestamp é o número de segundos entre a hora atual e 1st Janeiro de 1970 00:00:00 GMT. Também é conhecido como carimbo de data/hora UNIX.
  • Todas as funções date() do PHP usam o fuso horário padrão definido no arquivo php.ini
  • O fuso horário padrão também pode ser definido programaticamente usando scripts PHP.