java - 使用 Android 日历提供程序创建全天事件

Question

我希望我的应用程序能够将全天 Activity 插入到日历中。我从 https://developer.android.com/guide/topics/providers/calendar-provider.html 给出的例子开始.为了让它成为一整天，我添加了 ALL_DAY 内容值并将时区设置为 UTC。我最终得到以下代码:

long calID = 3;
long startMillis = 0; 
long endMillis = 0;     
Calendar beginTime = Calendar.getInstance();
beginTime.set(2012, 9, 14, 7, 30);
startMillis = beginTime.getTimeInMillis();
Calendar endTime = Calendar.getInstance();
endTime.set(2012, 9, 14, 8, 45);
endMillis = endTime.getTimeInMillis();

ContentResolver cr = getContentResolver();
values.put(Events.ALL_DAY, 1)
ContentValues values = new ContentValues();
values.put(Events.DTSTART, startMillis);
values.put(Events.DTEND, endMillis);
values.put(Events.TITLE, "Jazzercise");
values.put(Events.DESCRIPTION, "Group workout");
values.put(Events.CALENDAR_ID, calID);
values.put(Events.EVENT_TIMEZONE, "UTC");
Uri uri = cr.insert(Events.CONTENT_URI, values);

现在，这实际上完成了工作，但是 DTEND 时间似乎是多余的，并且设置开始和结束时间毫无意义，因为实际上只需要日期。当我删除 DTEND 值时，出现异常 java.lang.IllegalArgumentException: DTEND 和 DURATION cannot both be null for an event.。什么是正确的值(value)观？只是像上面那样随意，或者实际上可以/应该用有意义的信息来完成吗？

Answer 1

DTEND 不是多余的，因为它指定了事件的结束。 全天并不意味着只有一天。它可以跨越任意天数。 全天 表示事件的开始和结束没有时间组成部分。特别是， Activity 总是在一天开始时开始，无论您当时实际位于哪个时区。一个常见的例子是你的生日。您通常会在特定的日历日庆祝它，无论您身在何处。

请注意，在 Android 的日历数据库中，DTSTART 和 DTEND 应该代表 UTC 中特定日期的午夜。

因此，推导开始日期和结束日期的更好方法是:

TimeZone utc = TimeZone.getTimeZone("UTC");
Calendar beginTime = Calendar.getInstance(utc);
// set all values to 0
beginTime.clear();
beginTime.set(2012, 9, 14);
startMillis = beginTime.getTimeInMillis();

Calendar endTime = Calendar.getInstance(utc);
// the event ends right before the next day begins
endTime.clear();
endTime.set(2012, 9, 15);
endMillis = endTime.getTimeInMillis();

另请注意，DTEND 是非包含性的(它指向事件发生后的第一时刻)。对于一天的全天 Activity ，这意味着 DTEND 是第二天的开始。

另一种确定事件结束的方法是将事件的持续时间添加到 DTSTART 中，如下所示:

// Add the duration of 1 day to startMillis to get the end
endMillis = startMillis + TimeUnit.DAYS.toMillis(1);

结果同上。

请注意，这是创建非重复事件的方法。如果您创建重复性事件，则不能设置 DTEND，而是设置 DURATION。