mangstadt/biweekly

biweekly is an iCalendar library written in Java.

Michael Angstadt

@mangstadt

@marcoRS EXDATE is a separate property. You cannot define exclusion dates within the RRULE property. You might want to check out the VEvent.getDateIterator() method. It combines all the RRULE and EXDATE properties to give you a single date iterator.

Nils Kilden-Pedersen

@nilskp

Hi. Quick question: Why should I use biweekly over ical4j? What was the motivation for creating biweekly? Presumably it solves some issue(s) with ical4j?

Michael Angstadt

@mangstadt

@nilskp I created biweekly because I didn't like the way the ical4j codebase was organized. It was also fairly easy for me to get the project started because I could base it on my ez-vcard project (the vCard and iCalendar file formats are very similar). One benefit to using biweekly over ical4j is that it is more memory efficient. From what I understand, ical4j cannot handle large iCalendar files very well because it has to read the entire file into memory before it can process it. Biweekly streams the data, which means it requires much less memory. Hope that answers your question!

Nils Kilden-Pedersen

@nilskp

@mangstadt thanks! :+1:

Michael Angstadt

@mangstadt

No problem!

Simon Harrer

@simonharrer

Hi. I was fighting with the reuccurrences. In my calendar, there are dates that occur every two weeks, but once and a while, one day is off that bi-weekly schedule. How can I still get the recurrence setting so that the user sees that they are related? I was wondering if I can use the RecurrenceId for that? But I have not found any examples or anything in the documentation. Any idea how I can proceed?

Michael Angstadt

@mangstadt

@simonharrer You should be able to add an EXDATE (exception date) property to the VEVENT component. This property specifies individual dates that are to be excluded from the recurrence rule.

Simon Harrer

@simonharrer

Thanks for the quick reply. Hm, I think I have described it the wrong way. What I meant with one day off was that a specific event is not exactly every two weeks but once in a while 13 days until the next event and then the 14 day rule may continue. In other words: I have a sequence of events that follow a pattern such as every two weeks but some of those days may be one or two days earlier or later because of holidays. The best thing would be that I do not need a recurrence rule but could just link those days manually. What would you suggest?

Michael Angstadt

@mangstadt

@simonharrer You could use the EXDATE property to define the dates that the meetings will not be held on their normal date (as previously suggested). Then, add an RDATE (recurrence date) property to define the dates in which the meeting date is changed to account for holidays, etc. Does that make sense?

Simon Harrer

@simonharrer

Ah, now I think I get it. I could simply use the RDATE to just list all dates withouth any RRULE or EXDATE so model that sequence. Thank you!

Michael Angstadt

@mangstadt

@simonharrer That'd work too! Of course, you are limited to a finite set of dates, as opposed to RRULE, which is never-ending.

hawkfalcon

@codehawkfalcon_twitter

Hi @mangstadt thank you for your awesome library!

I do have a question if you are around

krshmbb

@krshmbb

@mangstadt We've noticed a few cases of clients sending us malformed VTimeZone DTStart values (not matching the local date-time format). As a result, ICalReader.readNext() throws a ClassCastException (java.lang.ClassCastException: biweekly.util.com.google.ical.values.DateValueImpl cannot be cast to biweekly.util.com.google.ical.values.DateTimeValue). I have a junit test and a possible solution in case you are interested. Let me know!

Michael Angstadt

@mangstadt

@krshmbb I am! Can you please put it in an issue?

Stooge7

@Stooge7

Hello, the site stopped hosting info about the timezones for outlook : http://www.tzurl.org/zoneinfo-outlook/Europe/

Stooge7

@Stooge7

opened an issue about it : mangstadt/biweekly#76

Michael Angstadt

@mangstadt

@Stooge7 Yikes, thanks for letting me know.

krshmbb

@krshmbb

@mangstadt Created an issue mangstadt/biweekly#77

Michael Angstadt

@mangstadt

@krshmbb Thanks, see my reply.

Somesh-tsr

@Somesh-tsr

Hi, Can we modify a particular date in a recurrent event?

Somesh-tsr

@Somesh-tsr

Hi Mike, can you please reply to above query. I have created a recurrence event. I want to delete one of the date in the date series. can you suggest any solution for this.

Nils Kilden-Pedersen

@nilskp

@Somesh-tsr it might help to ping @mangstadt. There, did it for you :-)

Michael Angstadt

@mangstadt

@Somesh-tsr The EXDATE property can be used to exclude specific dates from a recurrence rule. To add an EXDATE property to an iCalendar object using bikweely, call the VEvent.addExceptionDates() method.

Sergei Egorov

@bsideup

Hi! The lib is great! Does anyone know iOS (Swift) port or something?

Émile Fugulin

@Sytten

Hey! Small question, how would you make a diff of two .ics efficiently? Do you have features supporting this in the lib?

Michael Angstadt

@mangstadt

@Sytten Sorry, biweekly cannot make diffs.

Émile Fugulin

@Sytten

I will make my own algo then, no problem

Naftoli Gugenheim

@nafg

Is it ok to call .setDescription with a string that has newlines?

Michael Angstadt

@mangstadt

@nafg Yes. biweekly will automatically escape any special characters when it creates the iCalendar file.

Naftoli Gugenheim

@nafg

Thanks

Manuel Lorenzo

@noloman

hey guys

I have a question about the library: I'm integrating it in an Android project, but I can't find any instructions for ProGuard

Michael Angstadt

@mangstadt

Hi @noloman, what's your question?

Manuel Lorenzo

@noloman

hi @mangstadt ! my question is, is there any specific ProGuard lines that I should use? because without adding any line, the project won't build

Michael Angstadt

@mangstadt

@noloman Sorry, I don't know anything about ProGuard.

Malik

@Malik41556702_twitter

Hi Team, Can any one suggest me how to work with recurrence mid night event using Biweekly library?

Alon Dolev

@ayedo_gitlab

Hello! Does anybody have experience with sending biweekly generated ical files to gmail accounts? I'm generating an ical file with multiple events, and when I send it to gmail, it only recognises the first event, and suggests adding only this one to the calendar?

cfnz

@cfnz

Hi there, Just wondering how to best go about iterating over a daylight savings change. Say I have an event that starts at 3pm and I want the occurrences to stay at 3pm throughout the year whether it is daylight savings time or not.

dcamarasa

@dcamarasa

Hi @mangstadt . I want to use your library to create an event with a description that contains a link. How can I set the content to be formatted? I'm trying to follow indications in the following issue, but when I open the generated .ics file in Outlook it doesn't show any content/description: mangstadt/biweekly#71

Here is what I have:

...
VEvent event = new VEvent();
final String htmlDescription = "<a href=\"www.google.es\">Dummy link</a>";
RawProperty property = event.setExperimentalProperty("X-ALT-DESC", htmlDescription);
property.setParameter("FMTTYPE", "text/html");

Michael Angstadt

@mangstadt

@dcamarasa As per my email, try creating an accompanying DESCRIPTION property.

@cfnz If you specify a timezone for your event's start time and recurrence information, it will stay at 3 PM, irrespective of whether it's daylight savings or not.

dcamarasa

@dcamarasa

thanks. I'll try

dcamarasa

@dcamarasa

contacted Microsoft support team and basically Outlook does not support neither exporting nor importing ics files with formatted text. Maybe it was supported in the past but at this moment it's just not possible.

Michael Angstadt

@mangstadt

@dcamarasa Interesting, thanks for the update.

Kartikkman

@Kartikkman

Hi @mangstadt , first of all thanks a lot for this awesome library !! I don't how could I have solved the problem without it !!

Well , I am stuck at one point , I was using library for creating Events programmatically & then generating dates from them & it worked fine for all the cases but there was one ...

I tried to generate Monthly events , which occur on some week days at gap of some months ,
Rule Desc :

Repeat event every month on the nth z Day at a gap of X Months (
n : 1,2,3,4,Last
z :MONDAY,TUESDAY,THRUSDAY ,FRIDAY, etc
x -> Interval
)

but when I got dateIterator it doesn't contain all the days I specified in the Rule . Can you help me ?

I have attached the Code in the Image ,
Result is : [2020-06-05T00:00, 2020-08-07T00:00, 2020-10-05T00:00]

Kartikkman

@Kartikkman

Michael Angstadt

@mangstadt

@Kartikkman Can you write a unit test that demonstrates this?

Nakarima

@Nakarima

Hi, tzurl.org is down. Is there a way for specifying other address so i could self host this https://github.com/benfortuna/tzurl ?

Michael Angstadt

@mangstadt

Hi @Nakarima. You can provide your own VTIMEZONE components like so:

Where communities thrive

People

Repo info

Activity