Resumo da IA
Descrição
O wpforms_datetime_date_formats filtra os formatos de campo de data disponíveis para o Selecionador de data no construtor de formulários.
Parâmetros
- $formatos
- (array) (Obrigatório) Opções de formato de data.
Fonte
wpforms/includes/functions/data-presets.php
Mais informações
O filtro é aplicado a uma matriz que contém opções de formato para campos de data. Essas opções são fornecidas no construtor de formulários quando se usa a opção Date Picker.
Esse filtro pode ser usado para adicionar outras opções de formato. O formato determinará como as seleções de campo de data serão exibidas para o usuário, como as datas aparecerão nas entradas e notificações e também como as seleções de campo de data aparecerão no banco de dados.
As opções de formato de data padrão incluem:
- m/d/Y: 01/31/2019
- d/m/Y: 31/01/2019
- F j, Y: 31 de janeiro de 2019
Consulte a referência de data do PHP para obter opções adicionais de formato.
Exemplos
Em nosso exemplo abaixo, estamos mantendo todas as opções de data padrão, mas adicionando uma nova que terá a seguinte aparência:
Terça-feira, 27 de agosto de 2019 usando o l j \of F Y.
Observe que, no trecho, estamos escapando da 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