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.