Gostaria de personalizar a forma como as datas e horas são exibidas em seus WPForms? Usando os parâmetros de data e hora do PHP, é possível formatar datas e horas de várias maneiras para atender melhor aos seus formulários e às necessidades dos usuários.
Neste guia, vamos orientá-lo sobre os caracteres de formato de data e hora mais comuns do PHP.
Entendendo os caracteres de formato de data
Aqui está uma tabela com os caracteres mais comumente usados para formatar datas no WPForms:
| Caractere de formato | Descrição | exemplo de saída |
|---|---|---|
| d | Dia do mês, 2 dígitos com zeros à esquerda | 01 a 31 |
| D | Uma representação textual de um dia, três letras | De segunda a domingo |
| j | Dia do mês sem zeros à esquerda | 1 a 31 |
| l ("L" minúsculo) | Uma representação textual completa do dia da semana | De domingo a sábado |
| N | Representação numérica ISO 8601 do dia da semana | 1 (para segunda-feira) a 7 (para domingo) |
| S | Sufixo ordinal em inglês para o dia do mês, 2 caracteres | st, nd, rd ou th. Funciona bem com j |
| w | Representação numérica do dia da semana | 0 (para domingo) a 6 (para sábado) |
| z | O dia do ano (a partir de 0) | 0 a 365 |
| W | Número da semana ISO 8601 do ano, semanas começando na segunda-feira | Exemplo: 34 (a 34ª semana do ano) |
| F | Uma representação textual completa de um mês, como janeiro ou março | Janeiro a dezembro |
| m | Representação numérica de um mês, com zeros à esquerda | 01 a 12 |
| M | Uma representação textual curta de um mês, três letras | Janeiro a dezembro |
| n | Representação numérica de um mês, sem zeros à esquerda | 1 a 12 |
| t | Número de dias em um determinado mês | 28 a 31 |
| L | Seja em um ano bissexto | 1 se for um ano bissexto, 0 caso contrário. |
| o | Ano de numeração de semana ISO 8601. Tem o mesmo valor de Y, exceto pelo fato de que, se o número da semana ISO (W) pertencer ao ano anterior ou seguinte, esse ano será usado em seu lugar. | Exemplos: 1997 ou 2009 |
| Y | Uma representação numérica completa de um ano, com pelo menos 4 dígitos, com - para anos a.C. | Exemplos: -0044, 0657, 1997, 2006, 20191 |
| y | Uma representação de dois dígitos de um ano | Exemplos: 97 ou 06 |
| a | Letras minúsculas Ante meridiem e Post meridiem | manhã ou tarde |
| A | Maiúsculas Ante meridiem e Post meridiem | AM ou PM |
| g | Formato de 12 horas de uma hora sem zeros à esquerda | 1 a 12 |
| G | Formato de 24 horas de uma hora sem zeros à esquerda | 0 a 23 |
| h | Formato de 12 horas de uma hora com zeros à esquerda | 01 a 12 |
| H | Formato de 24 horas de uma hora com zeros à esquerda | 00 a 23 |
| i | Minutos com zeros à esquerda | 00 a 59 |
| s | Segundos com zeros à esquerda | 00 a 59 |
| u | Microssegundos | Exemplo: 654321 |
| v | Milissegundos | Exemplo: 654 |
| e | Identificador de fuso horário | Exemplos: UTC, GMT, America/New_York |
| I (i maiúsculo) | Se a data está ou não no horário de verão | 1 se houver horário de verão, 0 caso contrário. |
| O | Diferença para o horário de Greenwich (GMT) sem dois pontos entre horas e minutos | Exemplo: +0200 |
| P | Diferença para o horário de Greenwich (GMT) com dois pontos entre horas e minutos | Exemplo: +02:00 |
| T | Abreviação de fuso horário | Exemplos: EST, EDT |
| Z | Deslocamento de fuso horário em segundos | -43200 a 50400 |
| c | Data ISO 8601 | 2023-09-09T15:45:30-04:00 |
| r | Data formatada em RFC 2822 | Wed, 09 Sep 2023 15:45:30 -0400 |
Usando a formatação de data no WPForms
Para usar esses caracteres de formato no WPForms, você normalmente os combina em uma string. Aqui estão alguns exemplos comuns:
Y-m-d: 2024-10-21 (Ano-Mês-Dia)d/m/Y: 21/10/2024 (Dia/Mês/Ano)F j, Y: 21 de outubro de 2024 (Mês, Dia, Ano)D, d M Y: Seg, 21 Out 2024 (Dia abreviado, Dia Mês Ano)
Exemplos práticos no WPForms
Aqui estão algumas maneiras de usar a formatação de data personalizada no WPForms:
- Em Smart Tags: Use o
{date}tag inteligente com formatação personalizada:{date format="Y-m-d"}produziria a data atual como 2024-10-21{date format="F j, Y"}seria produzido em 21 de outubro de 2024
- Nos campos Data/Hora: Ao configurar um campo de Data/Hora, você pode personalizar o formato da data:
- Usando
d/m/Ypara um formato de dia/mês/ano - Uso
M j, Ypara um formato de nome de mês abreviado, como 21 de outubro de 2024
- Usando
Observação: o campo padrão Data/Hora no WPForms oferece opções limitadas de formato. Para usar formatos personalizados como os mencionados acima, você precisará criar formatos adicionais usando um snippet PHP. Consulte nosso guia sobre a criação de formatos adicionais de data/hora para obter mais detalhes.