### [wpforms_datetime_date_dropdowns](https://wpforms.com/developers/wpforms_datetime_date_dropdowns/) **Publicado:** 20 de fevereiro de 2020 **Autor:** Equipa Editorial **Resumo:** O filtro wpforms_datetime_date_dropdowns filtra os rótulos e opções no formato de lista suspensa do campo de data. **Conteúdo:** ## Descrição O filtro `wpforms_datetime_date_dropdowns` filtra os rótulos e opções no formato de lista suspensa do campo de data. ## Parâmetros $dates*(array) (Obrigatório)* Rótulos e intervalos numéricos usados nas listas suspensas de datas.$form\_id*(int) (Obrigatório)* ID do formulário.$field*(array) (Obrigatório)* Valores e propriedades do campo de data.## Origem `wpforms/pro/includes/fields/class-date-time.php` ## Mais Informações O filtro `wpforms_datetime_date_dropdowns` é aplicado a um array contendo opções de lista suspensa de datas. Pode ser usado para personalizar os rótulos das listas suspensas de mês, dia e ano, bem como quais opções estão incluídas em cada uma dessas listas suspensas. **Nota:** Os intervalos para dias, meses e anos só podem aceitar valores inteiros. ## Exemplos #### Limitar as datas Neste exemplo mostrado abaixo, a função limitará os meses de janeiro a junho, os dias do 1º ao 15º e o ano começará em 1980. A função também está a alterar os rótulos de `MM/DD/AAAA` para `M/D/A`. Lembre-se apenas de alterar o ID do formulário de `25` para corresponder ao ID específico do formulário em que deseja executar o seu código. Remover essa verificação executaria para todos os formulários. ``` /** * Filtra rótulos e opções no formato de lista suspensa do campo de data. * @link https://wpforms.com/developers/wpforms_datetime_date_dropdowns/ * * @param array $dates Argumentos de meses, dias e anos. * @param int $form_id ID do formulário. * @param array $field Valores e propriedades do campo de data. * * @return array */ function wpf_dev_datetime_date_dropdowns( $dates, $form_id, $field ) { // Executar apenas no meu formulário com ID = 25 if ( absint( $form_id ) !== 25 ) { return $ranges; } $ranges = array( 'months' => range( 1, 6 ), 'days' => range( 1, 15 ), 'years' => range( date( 'Y' ), 1980 ), 'months_label' => esc_html__( 'M', 'wpforms' ), 'days_label' => esc_html__( 'D', 'wpforms' ), 'years_label' => esc_html__( 'Y', 'wpforms' ), ); return $ranges; } add_filter( 'wpforms_datetime_date_dropdowns', 'wpf_dev_datetime_date_dropdowns', 10, 3 ); ``` Por favor, lembre-se de atualizar o ID do formulário no trecho para corresponder ao seu próprio ID de formulário. Se precisar de ajuda para encontrar o número do ID do seu formulário, [consulte este tutorial](https://wpforms.com/developers/how-to-locate-form-id-and-field-id/ "Como Localizar o ID do Formulário e o ID do Campo"). #### Expandir os anos Se desejar expandir os anos para que não parem em 2023, use este trecho e altere o ano máximo de `2050` para o que desejar. ``` /** * Filtra rótulos e opções no formato de lista suspensa do campo de data. * @link https://wpforms.com/developers/wpforms_datetime_date_dropdowns/ * * @param array $dates Argumentos de meses, dias e anos. * @param int $form_id ID do formulário. * @param array $field Valores e propriedades do campo de data. * * @return array */ function wpf_dev_datetime_date_dropdowns( $dates, $form_id, $field ) { $ranges = array( 'months' => range( 1, 12 ), 'days' => range( 1, 31 ), 'years' => range( date( 'Y' ), 2050 ), 'months_label' => esc_html__( 'MM', 'wpforms' ), 'days_label' => esc_html__( 'DD', 'wpforms' ), 'years_label' => esc_html__( 'YYYY', 'wpforms' ), ); return $ranges; } add_filter( 'wpforms_datetime_date_dropdowns', 'wpf_dev_datetime_date_dropdowns', 10, 3 ); ``` ## Relacionado Referência do Artigo: [Personalizar as Opções de Data do Campo de Data e Hora](https://wpforms.com/developers/customize-the-date-time-field-date-options/ "Personalizar as Opções de Data do Campo de Data e Hora") **Categorias:** Filtros Hooks **Etiquetas:** Campo de Data e Hora, PHP ---