5.6. Usando e Entendendo Datas

Up one level

Existem diversos tipos diferentes de datas para se escolher, sendo que muitas parecem similares. Por essa razão, é muito fácil se confundir sobre qual data usar. Abaixo, há uma definição de cada opção de data.

Definição das Datas

Data de Criação

É a data em que o documento foi feito, como se fosse seu aniversário, o dia em que nasceu. Não é possível modificar a Data de Criação de um objeto.

Data de Efetivação

É a data em que o objeto se torna público; ela pode ser personalizada através da aba Edição -> aba Data. Contudo, lá essa data é chamada de Data de Publicação (uma pequena discrepância na nomenclatura do Plone) A Data de Criação e a Data de Efetivação são muito parecidas. Ambas representam o início de um objeto. Ao escolher qual utilizar, é importante lembrar que um objeto pode ser criado muito antes de se tornar público. Você pode ter uma página na qual trabalhou por muitas semanas até, finalmente, publicá-la. Assim, você receberá resultados diferentes em uma Coleção, dependendo de qual data usar. Recomendamos utilizar a Data de Efetivação em vez da Data de Criação para Coleções que possuam esse critério. Assim, ela mostrará resultados com base no momento em que se tornaram visíveis ao público, o que é muito mais relevante. Além disso, também é possível ajustar manualmente a Data de Efetivação para controlar a ordem de classificação, o que não pode ser feito com a Data de Criação.

Data de Expiração

Refere-se ao dia em que o item não estará mais disponível ao público. Ela também pode ser personalizada através da aba Edição (vista acima) como a Data de Efetivação. No padrão, os objetos não possuem data Data de Expiração.

Data de Modificação 

É a data em que o objeto foi editado pela última vez. Note que essa data é estabelecida pela primeira vez quando o objeto é criado, e será modificada toda vez que ele for editado. Não há como personalizar essa data. Você pode usá-la como uma Ordem de Classificação juntamente com o critério Tipo de Item na Página, para exibir todas as páginas modificadas na última semana, por exemplo. A lista "What's New" na página inicial do LearnPlone.org utiliza a Data de Modificação como seu critério de data. Dessa forma, tanto os documentos recentemente criados quanto os recentemente atualizados aparecerão na lista.

Datas Específicas de Eventos

As duas datas seguintes se aplicam apenas aos objetos que são Eventos; elas são muito eficazes para a criação de Coleções de Eventos Recentes ou Próximos Eventos, comunicando seu público o que a sua organização está fazendo agora e o que fará no futuro.

Data Inicial

É simplesmente a data em que o Evento começa.

Data Final

É simplesmente a data em que o Evento termina.

Estabelecendo Datas

Algo confuso sobre as datas pode ser como configurar seus Critérios. Sua configuração é diferente de qualquer outro Critério. Em primeiro lugar, é preciso escolher se você deseja uma Data Relativa ou um Intervalo de Data.

A Data Relativa permite construir um estado condicional, como: itens modificados menos de 5 dias atrás. Um Intervalo de Data permite especificar um período exato de datas, como de 02/01/08 a 02/02/08. Isso é útil para criar uma Coleção com uma data permanente. A Data Relativa, por outro lado, é útil para criar Coleções que se atualizam automaticamente, como Coleções de Notícias Recentes ou uma Seção de Eventos Futuros.

Data Relativa

Ao olhar para a opção Data Relativa, você vê que há três opções a serem preenchidas.

A primeira opção é Qual Dia. Isso permite selecionar o número de dias que serão inclusos no critério. Uma das opções é chamada Agora; ela faz com que o período de data seja estabelecido para o dia atual. As outras duas opções não importam e podem ser ignoradas quando se utiliza o Agora.

 A segunda opção é No Passado ou Futuro e possibilita escolher olhar à frente ou atrás no tempo. A última opção é Mais ou Menos, que nos permite escolher entre três opções. Menos que permite incluir tudo que vai desde agora até um período de tempo igual ou menor à configuração Qual Dia, tanto no passado quanto no futuro. Mais que inclui tudo que está além do número de dias especificado ou maior que Qual Dia. Finalmente, No Dia inclui apenas as coisas que estão no dia especificado como Qual Dia. Usando o exemplo da imagem acima, se tivéssemos selecionado No Dia em vez de Mais que, nossa Coleção exibiria apenas os objetos modificados (estamos utilizando o critério Data de Modificação) 5 dias atrás. Se isso está confundindo você, tente pensar nisso como uma frase que substitui as opções escolhidas. "Quero que os resultados incluam Mais ou Menos que Qual Dia, No Passado ou Futuro". Nosso exemplo na imagem acima seria "Quero que os resultados incluam objetos Menos que 5 dias no passado.

Intervalo de Data

É muito mais fácil entender essa opção. Tanto uma Data Inicial quanto uma Data Final são necessárias (não confunda esses termos com datas Específicas de Eventos!). O Intervalo de Data permite introduzir uma data final e inicial para exibir tudo o que está dentro daquele período. Note também que isso permite especificar um momento específico do dia.