Data::...reeBusy(3pm)

💖 Data::ICal::Entry::FreeBusy — the 3pm manual, bestie edition 💖

okay so you're reading the Data::ICal::Entry::FreeBusy(3pm) page from the User Contributed Perl Documentation, and honestly? you're in the right place. grab a strawberry 🍓

---

✨ NAME ✨

Data::ICal::Entry::FreeBusy — it represents blocks of free and busy time in an iCalendar file. that's it, that's the whole job. 💅

---

🌸 SYNOPSIS 🌸

my $vfreebusy = Data::ICal::Entry::FreeBusy->new();
$vfreebusy->add_properties(
    organizer => 'MAILTO:jsmith@host.com',
    # Dat*e*::ICal is not a typo here
    freebusy   => Date::ICal->new( epoch => ... )->ical . '/' . Date::ICal->new( epoch => ... )->ical,
);

$calendar->add_entry($vfreebusy);

no fr, that Dat*e*::ICal in the comment is not a typo, the manpage says so itself. it's a whole different module from Data::ICal. do not come for me. 🙈

---

💜 DESCRIPTION 💜

so a Data::ICal::Entry::FreeBusy object is literally either asking "hey what's your free/busy situation" or answering that question, inside an iCalendar file. like a little calendar group chat. ✨

little heads up tho: the iCalendar RFC doesn't call these "entries", it calls them "components". same thing, different word, we move on. 🎀

and the nepo baby of it all: it's a subclass of Data::ICal::Entry and it accepts all of that class's methods. everything. all of it. periodt. 👑

---

💅 METHODS 💅

ical_entry_type

returns "VFREEBUSY" — that's its iCalendar entry name. iconic, honestly.

mandatory_unique_properties

the "uid" property is mandatory if "rfc_strict" was passed to "new" in Data::ICal. so like, only when you asked for the strict mode. no cap.

optional_unique_properties

according to the iCalendar standard, the following properties may be specified at most one time for a free/busy entry:

contact  dtstart  dtend  duration  dtstamp
organizer  uid  url

one and done. don't be greedy bestie. 🦋

optional_repeatable_properties

according to the iCalendar standard, the following properties may be specified any number of times for a free/busy entry:

attendee comment freebusy request-status

go off, go as many times as you want, this is your moment. 🔥

---

🧚 AUTHOR 🧚

Best Practical Solutions, LLC <modules@bestpractical.com>

---

🌈 LICENCE AND COPYRIGHT 🌈

Copyright (c) 2005 - 2020, Best Practical Solutions, LLC. All rights reserved.

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

---

okay we made it to the end, mwah 🫶 this was Data::ICal::Entry::FreeBusy(3pm) from perl v5.36.0, dated 2022-10-14 — yes that footer is real, that's just when this page was born, and we respect her history. bye bestie, go build a calendar 🎀✨💖