How to Create Additional Formats for the Date Field

Ver Markdown

Gostaria de personalizar como as datas aparecem em seus formulários? Embora o WPForms forneça três formatos de data padrão no campo Data/Hora do Seletor de Data, você pode facilmente adicionar mais formatos para atender às suas necessidades.

Este guia mostrará como criar formatos de data personalizados usando PHP.

Por padrão, o Seletor de Data do campo Data/Hora fornece três formatos de data diferentes para escolher.

os formatos padrão do seletor de datas mostrarão 3 formatos diferentes para escolher

Configurando Formatos de Data Personalizados

Para adicionar novos formatos de data, você precisará adicionar um trecho de código ao seu site. Se você não tem certeza de como adicionar código personalizado, consulte nosso guia sobre como adicionar trechos de código.

/**
 * Add additional formats for the Date field Date Picker
 *
 * @link https://wpforms.com/developers/how-to-create-additional-formats-for-the-date-field/
 */
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 December 2021
    $formats[ 'l, J F Y' ] = 'l, jS F Y';
    
    return $formats;
}
add_filter( 'wpforms_datetime_date_formats', 'wpf_dev_date_field_formats', 10, 1 );

Este formato de data nos permitirá inserir a data completa em um formato mais longo Segunda-feira, 20 de dezembro de 2021. Para encontrar mais formatos como este, consulte a documentação oficial de formatos do PHP.

Todas as datas são armazenadas como timestamps UNIX ao lado do formato legível. Embora a maioria dos formatos de data funcione perfeitamente, alguns formatos complexos podem afetar a capacidade do PHP de criar o timestamp corretamente.

Usando Separadores Personalizados

Para alterar o separador de data (por exemplo, de / para -), use este código:

/**
 * Change date separator format
 */
function wpf_dev_date_field_formats( $formats ) {
    // Adds new format 24-07-2021
    $formats[ 'j-m-y' ] = 'j-m-y';
    return $formats;
}
add_filter( 'wpforms_datetime_date_formats', 'wpf_dev_date_field_formats', 10, 1 );

Adicionando Palavras aos Formatos de Data

Para incluir palavras em seu formato de data (como “Segunda-feira, 20 de dezembro de 2021”), use este código:

/**
 * Add words to date format
 */
function wpf_dev_date_field_formats( $formats ) {
    // 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 );

Criação do Formulário

Em seguida, vamos criar nosso formulário e adicionar nossos campos. Isso incluirá um campo de formulário Data/Hora.

Se precisar de ajuda para criar um formulário, consulte esta documentação.

Depois de adicionar seu campo de formulário Data/Hora, clique na guia Opções do Campo e selecione Avançado para selecionar o Formato e escolher seu novo formato.

após adicionar este trecho, você pode escolher formatos adicionais para o seu seletor de datas

E é tudo que você precisa para criar formatos de data adicionais para o Seletor de Data do seu campo Data. Gostaria de personalizar o Seletor de Hora também? Por favor, revise nosso tutorial sobre Como Personalizar o Seletor de Hora do Campo Data e Hora.

Filtro de Referência

Referência de Filtro: wpforms_datetime_date_formats

Como Criar Formatos Adicionais para o Campo de Data

Resumo de IA