---
name: "HTML::Microformats::Format::hCalendar"
section: "3pm"
platform: "linux"
package: "libhtml-microformats-perl"
version: "0.105-6"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/HTML::Microformats::Format::hCalendar"
---

# HTML::Microformats::Format::hCalendar(3pm)

the hCalendar microformat

## NAME

HTML::Microformats::Format::hCalendar - the hCalendar microformat

## SYNOPSIS

```
 use HTML::Microformats::DocumentContext;
 use HTML::Microformats::Format::hCalendar;
 my $context = HTML::Microformats::DocumentContext->new($dom, $uri);
 my @cals    = HTML::Microformats::Format::hCalendar->extract_all(
                   $dom->documentElement, $context);
 foreach my $cal (@cals)
 {
   foreach my $event ($cal->get_vevent)
   {
     printf("%s: %s\n", $ev->get_dtstart, $ev->get_summary);
   }
 }
```

## DESCRIPTION

HTML::Microformats::Format::hCalendar inherits from HTML::Microformats::Format. See the base class definition for a description of property getter/setter methods, constructors, etc.

### Additional Method

- •

  `"to_icalendar"`

  This method exports the data in iCalendar format. It requires RDF::iCalendar to work, and will throw an error at run-time if it's not available.

## MICROFORMAT

HTML::Microformats::Format::hCalendar supports hCalendar as described at \<http://microformats.org/wiki/User:TobyInk/hcalendar-1.1\>.

## RDF OUTPUT

Data is returned using the W3C's revised iCalendar vocabulary (\<http://www.w3.org/2002/12/cal/icaltzd#\>) with some supplemental terms from Toby Inkster's revised iCalendar extensions vocabulary (\<http://buzzword.org.uk/rdf/icaltzdx#\>) and occasional other terms.

## BUGS

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

## SEE ALSO

HTML::Microformats::Format, HTML::Microformats.

## AUTHOR

Toby Inkster \<tobyink@cpan.org\>.

## COPYRIGHT AND LICENCE

Copyright 2008-2012 Toby Inkster

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.