Net::ICal::FreebusyItem -- represents the FREEBUSY property for VFREEBUSY objects.

  use Net::ICal;

  my $p1 = Net::ICal::Period->new("19970101T120000","19970101T123000");
  my $p2 = Net::ICal::Period->new("19970101T133000","19970101T140000");

  my $item1 = Net::ICal::FreebusyItem->new($p1, (fbtype => 'BUSY'));
  my $item2 = Net::ICal::FreebusyItem->new($p2, (fbtype => 'BUSY'));

  # TODO: we ought to be able to do things like:
    my $item3 = Net::ICal::FreebusyItem->new([$p1, $p2], (fbtype => 'BUSY'));
  # so that both items show up on the same line. 

FreebusyItems are used to mark sections of time that are free to be scheduled or that are already busy.

$period is a Net::ICal::Period object. In the future, this will change to be an array of Periods. Valid keys for the options hash are:

* fbtype - can be BUSY, FREE, BUSY-UNAVAILABLE, or BUSY-TENTATIVE; defaults to BUSY. BUSY means there's already something scheduled in this time slot. FREE means that this time slot is open. BUSY-UNAVAILABLE means that this time slot can't be scheduled. BUSY-TENTATIVE means that this time slot has something tentatively scheduled for it.

Net::ICal::Period, Net::ICal::Freebusy. There are a lot of semantics to handling these for real usage; see RFC2445.

More documentation can also be found in Net::ICal.