Codex

Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

pt-br:Formatando Data e Hora


cb-help.png
Ajuda ao Usuário WordPress
Referência da Ajuda Contextual - Este artigo é acessado a partir da Ajuda Contextual do WordPress PT-BR.
Procure nosso Fórum Oficial se precisar de mais ajuda sobre este assunto.

Personalizando Data e Hora

Algumas funções tag do WordPress são usadas para mostrar ou retornar informações de data e hora; the_date() e the_time() são exemplos disto. Algumas dessas funções aceitam um parâmetro chamado de uma seqüência de formato que lhe permite determinar como a data vai ser exibida. A seqüência de formato é um modelo em que várias partes da data são combinadas (usando os "caracteres de formato") para gerar uma data no formato especificado.

Por exemplo, o formato:

j \d\e F \d\e Y

cria uma data como:

14 de janeiro de 2011

Aqui está o que cada caractere de string de formatação acima representa:

  • j = Dia do Mês.
  • \d\e = Mostra a palavra de.
  • F = Nome completo do mês.
  • Y = Ano no formato de 4 dígitos.

WordPress é escrito na linguagem de programação PHP. A formatação de data no WordPress usa funções embutidas de formatação de data do PHP. Você pode usar a tabela de caracteres de formato de data no site do PHP como referência para a construção de cadeias de formato de data para uso em WordPress. Aqui está uma tabela de alguns dos itens mais úteis encontradas lá:

Dia do Mês
d Numérico, com zeros 01–31
j Numérico, em zeros 1–31
S Sufixo Ordinal Inglês, use depois de j st, nd, rd or th
Dia da Semana
l Nome Completo  (minúsucula 'L') Domingo – Sábado
D Nome com três letras Dom – Seg
Mês
m Numérico, com zeros 01–12
n Numérico, sem zeros 1–12
F Completo em texto Janeiro – Dezembro
M Três letras Jan - Dez
Ano
Y Numérico, 4 dígitos Ex.: 1999, 2003
y Numérico, 2 dígitos Ex.: 99, 03
Hora
a Minúscula am, pm
A Maiúscula AM, PM
g Hora, 12-hora, sem zeros 1–12
h Hora, 12-hora, com zeros 01–12
G Hora, 24-hora, sem zeros 0-23
H Hora, 24-hora, com zeros 00-23
i Minutos, com zeros 00-59
s Segundos, com zeros 00-59
T Abreviação de Fuso Horário Ex.: EST, MDT ...
Data/Hora Completa
c ISO 8601 2004-02-12T15:19:21+00:00
r RFC 2822 Ter, 21 Dez 2011 16:01:07 +0200

Examplos

Alguns exemplos de formatação de data.

  • F j, Y g:i a - Janeiro 6, 2010 12:50 am
  • F j, Y - Janeiro 6, 2010
  • F, Y - Janeiro , 2010
  • g:i a - 12:50 am
  • g:i:s a - 12:50:48 am
  • l, F jS, Y - Sábado, Janeiro 6th, 2010
  • M j, Y @ G:i - Nov 6, 2010 @ 0:50
  • Y/m/d \\a\\t g:i A - 2010/11/06 at 12:50 AM
  • Y/m/d \\a\\t g:ia - 2010/11/06 at 12:50am
  • Y/m/d g:i:s A - 2010/11/06 12:50:48 AM
  • Y/m/d - 2010/11/06

Combinado com the_time(), o código abaixo:

Esta postagem foi publicada em  <?php the_time('j \d\e F \d\e Y') ?> e está arquivada em <?php the_category(', ') ?>.

Mostra o seguinte:

Esta postagem foi publicada em 14 de janeiro de 2011 e está arquivada em Carros Antigos.

Observe que ao usar palavras acentuadas nos arquivos do WordPress, deverá usar o código da entidade de caractere. Saiba mais lendo o artigo HTML_ISO-8859-1 onde há também uma tabela de caracteres.

cb-warning.png
Artigo ou Seção com explicações avançadas
A seguir, estão explicações ou instruções para usuários avançados, o que pode exigir o conhecimento de termos e ferramentas não comuns a todas as pessoas.
Adicione {{Avançado}} para usar esta caixa.

Localização

Para usar outros formatos de datas e hora, veja sobre a função date_i18n().

Se quiser converter formatos de datas em strings de acordo com formatações regionais/territoriais, use __(), _e() etc demonstrado com get_the_date(__(…)):


Páginas da Ajuda acessada nos Painéis de Administração
VE
PaineisPainel Comentários Painel Discussão Painel Escrita Painel Exportar Painel Ferramentas-Disponíveis Painel Fundo Painel Geral| Painel Importar Painel Início Painel Leitura Painel Links Permanentes Painel Mídia Painel Mídia-Adicionar Nova Painel Menus Painel Meus Sites Painel Páginas-Todas as Páginas Painel Plugins-Instalados Painel Posts-Adicionar Novo Painel Rede Painel Tags Painel Temas Painel Todos os Links Painel Usuários-Seu perfil Painel Widgets
RecursosPublique Isso Resumo Cabeçalhos PersonalizadosCampos Personalizados Formatos de Posts
Rede e MultisiteCrie uma RedeDepurando uma Rede WordPress
DesenvolvimentoAPI WordPress XML-RPC Escrevendo um Plugin Funções e Capacidades Widgets em Temas
OutrosAtalhos de Teclado Glossário Formatando Data e Hora Primeiros Passos com o WordPress Spam em Comentários Usando Links Permanentes Cookies