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 is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.