Resumo da IA
Descrição
O wpforms_datetime_date_formats filtra os formatos de campo de data disponíveis para o Selecionador de datas no criador 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. Estas opções são fornecidas no construtor de formulários quando se utiliza a opção Date Picker.
Este filtro pode ser utilizado para acrescentar opções de formato adicionais. O formato determinará a forma como as selecções do campo de data são apresentadas ao utilizador, como as datas aparecem nas entradas e notificações e também como as selecções do campo de data aparecem na base de dados.
As opções de formato de data predefinidas 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 de formato adicionais.
Exemplos
No nosso exemplo abaixo, estamos a manter todas as opções de data predefinidas, mas estamos a adicionar uma nova que terá o seguinte aspeto:
Terça-feira, 27 de agosto de 2019 utilizando o l j \of F Y.
Observe que no trecho estamos escapando 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 );
Relacionadas
Referência do artigo: Como criar formatos adicionais para o campo de data