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.