Resumo de IA
Descrição
O filtro wpforms_datetime_date_formats formata os formatos de campo de data disponíveis para o Seletor de Data no construtor de formulários.
Parâmetros
- $formats
- (array) (Obrigatório) Opções de formato de data.
Origem
wpforms/includes/functions/data-presets.php
Mais Informações
O filtro é aplicado a um array contendo opções de formato para campos de data. Estas opções são fornecidas dentro do construtor de formulários ao usar a opção Seletor de Data.
Este filtro pode ser usado para adicionar opções de formato adicionais. O formato determinará como as seleções de campo de data são exibidas ao utilizador, como as datas aparecem nas entradas e notificações, e também como as seleções de campo de data aparecem na base de dados.
As opções de formato de data padrão incluem:
- m/d/Y: 31/01/2019
- d/m/Y: 31/01/2019
- F j, Y: 31 de Janeiro de 2019
Consulte a referência de data PHP para opções de formato adicionais.
Exemplos
No nosso exemplo abaixo, estamos a manter todas as opções de data padrão, mas a adicionar uma nova que terá o seguinte aspeto:
Terça-feira 27 de Agosto de 2019 usando l j \of F Y.
Note que no excerto estamos a escapar a palavra of com uma barra invertida (\).
/**
* Filters the date field formats available for the Date Picker in the form builder.
*
* @link https://wpforms.com/developers/wpforms_datetime_date_formats/
*
* @param array $formats Date format options.
* @return array
*/
function wpf_dev_date_field_formats( $formats ) {
// Item key is JS date character - see https://flatpickr.js.org/formatting/
// Item value is in PHP format - see http://php.net/manual/en/function.date.php
// Adds new format Monday, 20th of December 2021
$formats[ 'l, J \of F Y' ] = 'l, jS \of F Y';
return $formats;
}
add_filter( 'wpforms_datetime_date_formats', 'wpf_dev_date_field_formats', 10, 1 );
Relacionado
Referência do Artigo: Como Criar Formatos Adicionais para o Campo de Data