---
name: "Plucene::Document::DateSerializer"
section: "3pm"
platform: "linux"
package: "libplucene-perl"
version: "1.25-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Plucene::Document::DateSerializer"
---

# Plucene::Document::DateSerializer(3pm)

Utility functions for dealing with dates

## 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.