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