Função date() do PHP

Funções de Data / Tempo PHP

Exemplo

Formata a data e hora local e retorna a string de data formatada:

<?php
// Saída de dia
echo date("l") . "<br>";
// Saída de dia, data, mês, ano, hora AM ou PM
echo date("l jS \of F Y h:i:s A");
?>

Exemplo de execução

Definição e uso

A função date() formata a data e hora local e retorna a string de data formatada.

Sintaxe

date(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 (de 1 a 31)
  • l (minúsculo de 'L') - Representação textual completa do dia da semana
  • N - Representação numérica do dia da semana no formato ISO-8601 (1 representa Monday [Segunda-feira], 7 representa Sunday [Domingo])
  • S - Sufixo ordinal do dia do mês em inglês (2 caracteres: st, nd, rd ou th. Usado com j)
  • w - Representação numérica do dia da semana (0 representa Sunday [Domingo], 6 representa Saturday [Sábado])
  • z - Dia do ano (de 0 a 365)
  • W - Número da semana do ano no 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 (de 1 a 12)
  • t - Número de dias no mês dado
  • L - Se é um ano bissexto (se for, 1, caso contrário, 0)
  • o - Número do ano no padrão ISO-8601
  • Y - Representação de quatro dígitos do ano
  • y - Representação de dois dígitos do ano
  • a - A forma minúscula representa: 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 (Greenwich Mean Time), em horas (por exemplo: +0100)
  • P - Diferença em relação ao GMT (Greenwich Mean Time), 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 horários ocidentais é 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: Sex, 12 Abr 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 pode ser usado 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: Sex, 12 Abr 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: Sex, 12 Abr 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. Especifica o timestamp inteiro Unix. O padrão é o tempo local atual (time()).

Detalhes Técnicos

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

PHP 5.1.0: Adicionados E_STRICT e E_NOTICE para erros de fuso horário. O intervalo de timestamps válido é 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 foi limitado de 01-01-1970 a 19-01-2038.

PHP 5.1.1: Constantes de formatos de data/hora padrão adicionadas, usadas para especificar format Parâmetros.

Funções de Data / Tempo PHP