NAME

HTML::Microformats::Datatype::RecurringDateTime - a datetime that recurs

SYNOPSIS

 my $r_datetime = HTML::Microformats::Datatype::RecurringDateTime->new($ical_string);
 print "$r_datetime\n";

DESCRIPTION

Constructors

$r = HTML::Microformats::Datatype::RecurringDateTime->new($string, [$context])

Creates a new HTML::Microformats::Datatype::RecurringDateTime object.

$string is an iCalendar-RRULE-style string.

$r = HTML::Microformats::Datatype::RecurringDateTime->parse($string, $elem, $context)

Creates a new HTML::Microformats::Datatype::RecurringDateTime object.

$string is perhaps an iCalendar-RRULE-style string. $elem is the XML::LibXML::Element being parsed. $context is the document context.

This constructor supports a number of experimental microformat interval patterns. e.g.

 <span class="rrule">
    The summer lectures are held held <span class="freq">yearly</span>,
    every <span class="interval">2</span>nd year (1999, 2001, etc),
    every <span class="byday">Sunday</span>
    in January <abbr class="bymonth" title="1" style="display:none"></abbr>
    at <span class="byhour">8</span>:<span class="byminute">30</span> and
    repeated at <span class="byhour">9</span>:30.
 </span>

$r = HTML::Microformats::Datatype::RecurringDateTime->parse_string($string, [$context])

Essentially just an alias for new.

Public Methods

$r->to_string: Returns an iCal-RRULE-style formatted string representing the recurrance.
$r->datatype: Returns an the RDF datatype URI representing the data type of this literal.
$r->add_to_model($model): Adds the recurring datetime to an RDF model as a resource (not a literal).

BUGS

Please report any bugs to http://rt.cpan.org/.

AUTHOR

Toby Inkster <tobyink@cpan.org>.

COPYRIGHT

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

DISCLAIMER OF WARRANTIES

THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

CPAN RT