Campo Seletor de Datas (Date Picker)
O campo seletor de datas (date picker) cria um seletor jQuery de datas. Este campo é muito útil quando temos postagens que precisam exibir uma data diferente da data de publicação, como a data de início e fim de um determinado evento.
Campos adicionais deste tipo de campo
- Formato dos dados: A string que representa a seqüência do formato da data. Este será o formato em que a data será guardada no banco de dados e retornada pela API. Se você pretende usar este campo para ordenar seus posts, por favor deixe o formato como yymmdd. Observe também que a seqüência de formato de data em JS é um pouco diferente de uma versão PHP, então você não vai usar o mesmo formato de quando configura a data que aparece em um post, nas opções do WordPress. Leia mais sobre formatos de data jQuery
- Formato de exibição: Este será o formato em que a data será exibidada para o usuário. “dd/mm/yy” é o formato de exibição mais utilizado para nosso padrão brasileiro. Leia mais sobre formatos de data jQuery
- Semana começa em: Usado apenas para definir qual será a primeira coluna do date picker exibido.
Como utilizar este campo em um template WP?
A API irá retornar uma string contendo a data no formato configurado previamente.
Dica: Você pode usar a função dateTime do PHP para ter maior controle sobre o valor retornado.
Se você planeja a sua data de saída esteja em um formato diferente, lembre-se que o formato de data em JS em em PHP são diferentes, e estarão exemplificados no final.
<?php
/*
* Exibindo valor único
*/
?>
<p>Posted on: <?php the_field('data-evento'); ?></p>
<?php
/*
* Criando um objeto PHP DateTime oa partir do valor do Date Picker Value
* este exemplo foi feito pensando no formato da data salva estar como: yymmdd (JS) = Ymd (PHP)
*/
$date = DateTime::createFromFormat('Ymd', get_field('data-evento'));
echo $date->format('d-m-Y');
/*
* Ordenação de posts baseado nas datas do Date Picker value
*/
$posts = get_posts(array(
'meta_key' => 'data-evento', // name of custom field
'orderby' => 'meta_value_num',
'order' => 'ASC'
));
if( $posts )
{
foreach( $posts as $post )
{
setup_postdata( $post );
// ...
}
wp_reset_postdata();
}
/*
* Exemplos de formatos e suas diferenças em JS e PHP
*/
$js = "yymmdd"
$php = "Ymd"
$js = "dd/mm/yy"
$php = "d/m/Y"
$js = "yy_mm_dd"
$php = "Y_m_d"
?>
Traduzindo para outros formatos de datas
Se você precisar exibir a data num formato não americano, o WordPress contém a função date_i18n que te deixa fazer tais conversões de formatos de data.
<?php
$dateformatstring = "l d F, Y";
$unixtimestamp = strtotime(get_field('data-evento'));
echo date_i18n($dateformatstring, $unixtimestamp);
?>
Formatação de valor ( PHP < 5.3)
Se o servidor estiver executando uma versão do PHP anterior à 5.3, o mais provável é que você não tenha acesso à classe DateTime e suas funções. Como um paleativo, você pode usar as funções strtotime e date para formatar o valor.
<?php
$date = get_field('data-evento');
// $date = 19881123 (23/11/1988)
// extraindo dia (D), mês (M) e ano (Y)
$d = substr($date, 6, 2);
$m = substr($date, 4, 2);
$y = substr($date, 0, 4);
// formato de data UNIX
$time = strtotime("{$d}-{$m}-{$y}");
// formato de data (23/11/1988)
echo date('d/m/Y', $time);
// formato de data americano (November 11th 1988)
echo date('F n Y', $time);
?>
Date Query
Lembre-se que é possível utilizar o date_query do WordPress para ordenar suas postagens da forma que você precisar. Para isso, leiam os exemplos em https://codex.wordpress.org/Class_Reference/WP_Query#Date_Parameters
