NAME

Plucene::Document::DateSerializer - Utility functions for dealing with dates

SYNOPSIS

        use Plucene::Document::DateSerializer
        my $field = Plucene::Document::Field->Text(
                date => freeze_date(Time::Piece $t)
        );
        $doc->add($field);

DESCRIPTION

Dates and times in Plucene should be serialized using the "freeze_date" function so that the Plucene::Search::DateFilter can filter on them during future searches.

SUBROUTINES

freeze_date

        my $string = freeze_date(Time::Piece $t)

This routine, exported by default, turns a "Time::Piece" object into a string in a format expected by both Plucene and Lucene.

thaw_date

        my Time::Piece $t = Plucene::Document::DateSerializer::thaw_date($string)

This routine is not exported, and is not used by the Plucene core. It is useful for debugging dates, and simply reverses the "freeze_date" operation.