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 );


Referência do artigo: Como criar formatos adicionais para o campo de data