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

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.