How to Create Additional Formats for the Date Field

Ver Markdown

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

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

Por defeito, 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

Configurar Formatos de Data Personalizados

Para adicionar novos formatos de data, precisará de adicionar um trecho de código ao seu site. Se não tiver a certeza de como adicionar código personalizado, consulte o 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 permitir-nos-á inserir a data completa num 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 juntamente com o formato legível. Embora a maioria dos formatos de data funcione sem problemas, alguns formatos complexos podem afetar a capacidade do PHP de criar o timestamp corretamente.

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

Adicionar Palavras a Formatos de Data

Para incluir palavras no 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 o nosso formulário e adicionar os nossos campos. Isto incluirá um campo de formulário Data/Hora.

Se precisar de alguma assistência na criação de um formulário, por favor consulte esta documentação.

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

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

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

Filtro de Referência

Referência do Filtro: wpforms_datetime_date_formats

Como Criar Formatos Adicionais para o Campo de Data

Resumo de IA