---
name: "HTTP::Headers::ActionPack::DateHeader"
section: "3pm"
platform: "linux"
package: "libhttp-headers-actionpack-perl"
version: "0.09-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/HTTP::Headers::ActionPack::DateHeader"
---

# HTTP::Headers::ActionPack::DateHeader(3pm)

A Date Header

## NAME

HTTP::Headers::ActionPack::DateHeader - A Date Header

## VERSION

version 0.09

## SYNOPSIS

```
  use HTTP::Headers::ActionPack::DateHeader;
  # create from string
  my $date = HTTP::Headers::ActionPack::DateHeader->new_from_string(
      'Mon, 23 Apr 2012 14:14:19 GMT'
  );
  # create using Time::Peice object
  my $date = HTTP::Headers::ActionPack::DateHeader->new(
      $timepeice_object
  );
```

## DESCRIPTION

This is an object which represents an HTTP header with a date. It will inflate the header value into a Time::Piece object and proxy most of the relevant methods.

## DateTime compatibility

I opted to not use DateTime (by default) for this class since it is not a core module and can be a memory hog at times. That said, it should be noted that DateTime objects are compatible with this class. You will need to pass in a DateTime instance to `"new"` and after that everything should behave properly. If you want `"new_from_string"` to inflate strings to DateTime objects you will need to override that method yourself.

## METHODS

- "date"

  Returns the underlying Time::Piece object.

- "new\_from\_string ( $date\_header\_string )"

  This will take an HTTP header Date string and parse it into and object.

- "as\_string"

  - "second"

  - "minute"

  - "hour"

  - "day\_of\_month"

  - "month\_number"

  - "fullmonth"

  - "month"

  - "year"

  - "day\_of\_week"

  - "day"

  - "fullday"

  - "epoch"

  These delegate to the underlying Time::Piece object.

## AUTHOR

Stevan Little \<stevan.little@iinteractive.com\>

## CONTRIBUTORS

- •

  Andrew Nelson \<anelson@cpan.org\>

- •

  Dave Rolsky \<autarch@urth.org\>

- •

  Florian Ragwitz \<rafl@debian.org\>

- •

  Jesse Luehrs \<doy@tozt.net\>

- •

  Karen Etheridge \<ether@cpan.org\>

## COPYRIGHT AND LICENSE

This software is copyright (c) 2012 by Infinity Interactive, Inc..

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.