Resumo : neste tutorial, você aprenderá como usar a date()
função PHP para formatar um carimbo de data/hora usando um formato especificado.
Introdução à função data() do PHP
A date()
função formata um carimbo de data/hora usando um formato especificado:
date(string $format, int|null $timestamp = null): string
Linguagem de código: PHP ( php )
A date()
função possui dois parâmetros:
$format
é uma string que determina como$timestamp
deve ser formatado.$timestamp
é um carimbo de data/hora Unix. O$timestamp
parâmetro é opcional. Se você omitir$timestamp
ou usarnull
, o padrão será o carimbo de data/hora atual . Em outras palavras, o padrão é o valor datime()
função.
A date()
função retorna a string de data formatada.
Parâmetros de formato de data PHP
Para formatar uma data, você usa os seguintes parâmetros de formato de data:
format personagem |
Descrição | Exemplos de valores retornados |
---|---|---|
Dia | – | – |
d |
2 dígitos com zeros à esquerda que representam o dia do mês | 01 para 31 |
D |
Três letras que apresentam o nome do dia | Mon através Sun |
j |
Dia do mês sem zeros à esquerda | 1 para 31 |
l (‘L’ minúsculo) |
Nome completo do dia da semana | Sunday através Saturday |
N |
Dia da semana em número de acordo com ISO-8601 | 1 (para segunda-feira) até 7 (para domingo) |
S |
2 caracteres que representam o sufixo ordinal do dia do mês em inglês | st , nd , rd ou th |
w |
Um dia numérico da semana | 0 (para domingo) até 6 (para sábado) |
z |
Um dia numérico do ano, começando em 0 | 0 através 365 |
Semana | – | – |
W |
Número da semana do ano na ISO-8601, semanas começando na segunda-feira | Exemplo: 3 (a 3ª semana do ano) |
Mês | – | – |
F |
O nome completo do mês | January através December |
m |
O número do mês com zeros à esquerda | 01 através 12 |
M |
Três caracteres que representam o nome do mês | Jan através Dec |
n |
O número do mês sem zero à esquerda | 1 através 12 |
t |
O número de dias em um mês | 28 através 31 |
Ano | – | – |
L |
Retorne 1 se for ano bissexto e zero caso contrário | |
o |
Ano de numeração de semanas ISO-8601. Tem o mesmo valor que Y , exceto que se o número da semana ISO ( W ) pertencer ao ano anterior ou seguinte, esse ano será usado. |
Exemplos: 1999 ou 2003 |
Y |
Um número de quatro dígitos representa um número de ano | Exemplos: 2020 ou 2021 |
y |
Uma representação de dois dígitos de um ano | Exemplos: 99 ou 03 |
Tempo | – | – |
a |
Letras minúsculas am ou pm | am ou pm |
A |
AM ou PM em letras maiúsculas | AM ou PM |
B |
Amostra do horário da Internet | 000 através 999 |
g |
Formato de 12 horas sem zeros à esquerda | 1 através 12 |
G |
Formato de 24 horas sem zeros à esquerda | 0 através 23 |
h |
Formato de 12 horas com zeros à esquerda | 01 através 12 |
H |
Formato de 24 horas com zeros à esquerda | 00 através 23 |
i |
Minutos com zeros à esquerda | 00 para 59 |
s |
Segundos com zeros à esquerda | 00 através 59 |
u |
Microssegundos. | Exemplo: 654321 |
v |
Milissegundos. | Exemplo: 654 |
Fuso horário | – | – |
e |
Identificador de fuso horário | Exemplos: UTC , GMT , Europe/Berlin |
I (i maiúsculo) |
Horário de verão | 1 se for horário de verão, 0 caso contrário. |
O |
Diferença para GMT sem dois pontos entre horas e minutos | Exemplo: +0200 |
P |
Diferença para GMT com dois pontos entre horas e minutos | Exemplo: +02:00 |
p |
O mesmo que P , mas retorna Z em vez de +00:00 |
Exemplo: +02:00 |
T |
Abreviação do fuso horário | Exemplos: CEST , MDT … |
Z |
Deslocamento de fuso horário em segundos. | -43200 através 50400 |
Data/Hora Completa | – | – |
c |
Data ISO 8601 | 2021-07-14T13:38:04+02:00 |
r |
Data formatada RFC 2822 | Quarta, 14 de julho de 2021 13:38:20 +0200 |
U |
Segundos desde 1º de janeiro de 1970 00:00:00 GMT (a Época Unix) |
Exemplos de funções PHP date()
Vejamos alguns exemplos práticos de uso da date()
função.
1) Usando a função PHP date() para mostrar o exemplo do ano atual
O exemplo a seguir usa a date()
função para mostrar como exibir o ano atual:
<?php
echo date('Y');
Linguagem de código: PHP ( php )
Isso é útil especialmente quando você deseja exibir os direitos autorais no rodapé de um site ou aplicativo da web:
<p>Copyright © <?php echo date('Y') ?> - by tutorials.acervolima.com. All rights reserved.</p>
Linguagem de código: PHP ( php )
2) Usando a função date() para formatar uma data para o banco de dados MySQL
Para inserir uma data em uma coluna datetime no banco de dados MySQL , você usa o seguinte formato de data:
YYYY-MM-DD HH:MM:SS
Linguagem de código: PHP ( php )
Em PHP, é equivalente ao seguinte formato:
Y-m-d H:i:s
Linguagem de código: PHP ( php )
Por exemplo:
<?php
$created_at = date("Y-m-d H:i:s");
echo $created_at;
Linguagem de código: PHP ( php )
Saída:
2021-07-14 13:03:08
Linguagem de código: PHP ( php )
Resumo
- Use a função PHP
date()
para formatar um carimbo de data/hora em um formato especificado.