Função PHP date_format ()

Definição e Uso

Esta função é um alias de DateTime::format()função. Ele aceita um objeto DateTime e uma string de formato (representando um formato de data / hora desejado) como parâmetros, formata o objeto no formato especificado e retorna o resultado.

Sintaxe

date_format($date_time_object, $format)

Parâmetros

Sr. Não	Parâmetro e Descrição
1	date_time_object(Mandatory) Este é o objeto DateTime que você precisa formatar.
2	format(Mandatory) Esta é a string que representa o formato desejado.

Valores Retornados

A função PHP date_format () retorna a string de data formatada

Versão PHP

Esta função foi introduzida pela primeira vez no PHP versão 5.2.1 e funciona em todas as versões posteriores.

Exemplo

Experimente o seguinte exemplo aqui, estamos criando um objeto DateTime e formatando-o -

<?php
   //Creating a DateTime object
   $date_time_Obj = date_create("25-09-1989");
   //formatting the date/time object
   $format = date_format($date_time_Obj, "y-d-m");
   print("Date in yy-dd-mm format: ".$format); 
?>

Isso produzirá o seguinte resultado -

Date in yy-dd-mm format: 89-25-09

Exemplo

O exemplo a seguir formata um objeto DateTime como data e hora separadamente -

<?php
   $dateString = '11-06-2012 12:50:41 GMT';
   $dateTimeObj = date_create($dateString);
   $date = date_format($dateTimeObj, 'd-m-y');
   print("Date: ".$date); 
   print("\n");
   $time = date_format($dateTimeObj, 'H:i:s');
   print("Time: ".$time); 
?>

Isso produzirá o seguinte resultado -

Date: 11-06-12
Time: 12:50:41

Exemplo

O exemplo a seguir demonstra algumas strings de formato válidas em PHP -

<?php
   $dateTimeObj = date_create("11-06-2012 12:50:41 GMT");
   print("Date in y-m-d format: ".date_format($dateTimeObj, 'Y-m-d'));
   print("\n");
   print("Date in d/m/y format: ".date_format($dateTimeObj, 'd/m/y'));
   print("\n");
   print("Date in Y-m-d H:i:s format: ".date_format($dateTimeObj, 'Y-m-d H:i:s'));
   print("\n");
   print("Date in G:i:A format: ".date_format($dateTimeObj, 'G-i-A'));
?>

Isso produzirá o seguinte resultado -

Date in y-m-d format: 2012-06-11
Date in d/m/y format: 11/06/12
Date in Y-m-d H:i:s format: 2012-06-11 12:50:41
Date in G:i:A format: 12-50-PM

Exemplo

O exemplo a seguir cria uma nova data usando o método date_format () -

<?php
   $dateSrc = '2005-04-19 12:50 GMT';
   $dateTime = date_create( $dateSrc);;
   # Now set a new date using date_format();
   date_format( $dateTime, 2000, 12, 12);
   
   echo "New Formatted date is ". $dateTime->format("Y-m-d\TH:i:s\Z");
   echo "
";

   # Using second function.
   $dateTime = new DateTime($dateSrc);
   $dateTime->setDate( 1999, 10, 12);
   
   echo "New Formatted date is ". $dateTime->format("Y-m-d\TH:i:s\Z");
?>

Isso produz a seguinte saída -

New Formatted date is 2000-12-12T12:50:00Z
New Formatted date is 1999-10-12T12:50:00Z

String de formato

Existem certos caracteres com significado predefinido, usando os quais você pode criar uma string de formato. Eles são:

d - O dia do mês (de 01 a 31)
D - Uma representação textual de um dia (três letras)
j - O dia do mês sem zeros à esquerda (1 a 31)
l ('L' minúsculo) - Uma representação textual completa de um dia
N - A representação numérica ISO-8601 de um dia (1 para segunda-feira a 7 para domingo)
S - O sufixo ordinal inglês para o dia do mês (2 caracteres st, nd, rd ou th. Funciona bem com j)
w - uma representação numérica do dia (0 para domingo a 6 para sábado)
z - O dia do ano (de 0 a 365)
W - O número da semana ISO-8601 do ano (semanas começando na segunda-feira)
F - Uma representação textual completa de um mês (janeiro a dezembro)
m - Uma representação numérica de um mês (de 01 a 12)
M - Uma breve representação textual de um mês (três letras)
n - uma representação numérica de um mês, sem zeros à esquerda (1 a 12)
t - O número de dias em determinado mês
L - Se é um ano bissexto (1 se for um ano bissexto, 0 caso contrário)
o - O número do ano ISO-8601
Y - uma representação de quatro dígitos de um ano
y - uma representação de dois dígitos de um ano
a - am ou pm minúsculos
A - maiúsculas AM ou PM
B - Tempo de Internet da amostra (000 a 999)
g - formato de 12 horas de uma hora (1 a 12)
G - formato de 24 horas de uma hora (0 a 23)
h - formato de 12 horas de uma hora (01 a 12)
H - formato de 24 horas de uma hora (00 a 23)
i - Minutos com zeros à esquerda (00 a 59)
s - segundos, com zeros à esquerda (00 a 59)
e - O identificador do fuso horário (Exemplos: UTC, Atlântico / Açores)
I (capital i) - se a data está no horário de verão (1 se for o horário de verão, 0 caso contrário)
O - Diferença para o horário de Greenwich (GMT) em horas (Exemplo: +0100)
T - Configuração de fuso horário da máquina PHP (exemplos: EST, MDT)
Z - deslocamento de fuso horário em segundos. O deslocamento a oeste do UTC é negativo e o deslocamento a leste do UTC é positivo (-43200 a 43200)
c - A data ISO-8601 (por exemplo, 2004-02-12T15: 19: 21 + 00: 00)
r - A data formatada RFC 2822 (por exemplo, Qui, 21 de dezembro de 2000 16:01:07 +0200)
U - Os segundos desde a época do Unix (1 de janeiro de 1970 00:00:00 GMT)

↰ Previous page