Função gmdate() do PHP

Funções de Data / Hora do PHP

Exemplo

Formata a data e hora GMT/UTC e retorna a string de data formatada:

<?php
// Imprime o dia da semana
echo gmdate("l") . "<br>";
// Imprime o dia da semana, dia, mês, ano, hora, manhã ou tarde
echo gmdate("l jS \of F Y h:i:s A");
?>

Exemplo de execução

Definição e uso

A função gmdate() formata a data e hora GMT/UTC e retorna a string de data formatada.

Sintaxe

gmdate(format,timestamp);
Parâmetro Descrição
format

Obrigatório. Define o formato da string de data de saída. Pode usar os seguintes caracteres:

  • d - Dia do mês (de 01 a 31)
  • D - Representação textual do dia da semana (usando três letras)
  • j - Dia do mês, sem zeros à esquerda (1 a 31)
  • l (forma minúscula de 'L') - Representação textual completa do dia da semana
  • N - Representação numérica do dia da semana conforme o formato ISO-8601 (1 para Monday[Segunda-feira], 7 para Sunday[Domigo])
  • S - Sufixo ordinal em inglês do dia do mês (2 caracteres: st, nd, rd ou th. Usado com j)
  • w - Representação numérica do dia da semana (0 para Sunday[Domingo], 6 para Saturday[Sábado])
  • z - Dia do ano (de 0 a 365)
  • W - Número da semana no ano conforme o formato ISO-8601 (a semana começa com Monday[Segunda-feira])
  • F - Representação textual completa do mês (Janeiro[Janeiro] a Dezembro[Dezembro])
  • m - Representação numérica do mês (de 01 a 12)
  • M - Representação abreviada do mês (usando três letras)
  • n - Representação numérica do mês, sem zeros à esquerda (1 a 12)
  • t - Número de dias no mês especificado
  • L - Se é um ano bissexto (1 se for, 0 caso contrário)
  • o - Ano numérico conforme o padrão ISO-8601
  • Y - Representação de quatro dígitos para o ano
  • y - Representação de dois dígitos para o ano
  • a - Representação em minúsculas: am ou pm
  • A - Representação em maiúsculas: AM ou PM
  • B - Swatch Internet Time (000 a 999)
  • g - Hora no sistema de 12 horas sem zero à esquerda (1 a 12)
  • G - Hora no sistema de 24 horas sem zero à esquerda (0 a 23)
  • h - Hora no sistema de 12 horas com zero à esquerda (01 a 12)
  • H - Hora no sistema de 24 horas com zero à esquerda (00 a 23)
  • i - Minutos com zero à esquerda (00 a 59)
  • s - Segundos com zero à esquerda (00 a 59)
  • u - Microsegundos (adicionado no PHP 5.2.2)
  • e - Identificador do fuso horário (por exemplo: UTC, GMT, Atlantic/Azores)
  • I (maiuscula de i) - Se a data está no horário de verão (se estiver, 1, caso contrário, 0)
  • O - Diferença em relação ao GMT (GMT) em horas (por exemplo: +0100)
  • P - Diferença em relação ao GMT (GMT) em horas:minutos (adicionado no PHP 5.1.3)
  • T - Abreviação do fuso horário (por exemplo: EST, MDT)
  • Z - Deslocamento de fuso horário em segundos. O deslocamento para fusos ocidentais em UTC é negativo (-43200 a 50400)
  • c - Data no padrão ISO-8601 (por exemplo: 2013-05-05T16:34:42+00:00)
  • r - Data no formato RFC 2822 (por exemplo: Fri, 12 Apr 2013 12:01:05 +0200)
  • U - Número de segundos transcorridos desde o início da era Unix (1 de janeiro de 1970 00:00:00 GMT)

Além disso, também podem ser usados os seguintes constantes pré-definidas (disponíveis desde o PHP 5.1.0):

  • DATE_ATOM - Atom (por exemplo: 2013-04-12T15:52:01+00:00)
  • DATE_COOKIE - HTTP Cookies (por exemplo: Friday, 12-Apr-13 15:52:01 UTC)
  • DATE_ISO8601 - ISO-8601 (por exemplo: 2013-04-12T15:52:01+0000)
  • DATE_RFC822 - RFC 822 (por exemplo: Fri, 12 Apr 13 15:52:01 +0000)
  • DATE_RFC850 - RFC 850 (por exemplo: Friday, 12-Apr-13 15:52:01 UTC)
  • DATE_RFC1036 - RFC 1036 (por exemplo: Fri, 12 Apr 13 15:52:01 +0000)
  • DATE_RFC1123 - RFC 1123 (por exemplo: Fri, 12 Apr 2013 15:52:01 +0000)
  • DATE_RFC2822 - RFC 2822 (Fri, 12 Apr 2013 15:52:01 +0000)
  • DATE_RFC3339 - Igual a DATE_ATOM (a partir do PHP 5.1.3)
  • DATE_RSS - RSS (Fri, 12 Aug 2013 15:52:01 +0000)
  • DATE_W3C - World Wide Web Consortium (por exemplo: 2013-04-12T15:52:01+00:00)
timestamp Opcional. Define o timestamp inteiro Unix. O padrão é o horário local atual (time()).

Detalhes Técnicos

Retorno: Se for bem-sucedido, retorna a string de data formatada; se falhar, retorna E_WARNING e FALSE.
Versão PHP: 4+
Log de Atualizações:

PHP 5.1.0: O intervalo válido do timestamp é de 13 de dezembro de 1901 20:45:54 GMT sexta-feira até 19 de janeiro de 2038 03:14:07 GMT segunda-feira. Nas versões anteriores a 5.1.0, em alguns sistemas (por exemplo, Windows), o timestamp é limitado de 01-01-1970 a 19-01-2038.

PHP 5.1.1: Adicionado constante de formato de data/hora padrão, usada para especificar format Parâmetros.

Funções de Data / Hora do PHP