Android日曆：如何創建自定義事件

一、介紹

在日常生活中，我們經常需要使用日曆來提醒自己的各種重要事項，對於Android開發者來說，Android系統提供了強大的日曆API，可以讓我們方便地創建、編輯和刪除日曆事件。本文將介紹如何使用Android日曆API在應用中創建自定義事件。

二、獲取日曆ID

在創建日曆事件之前，我們需要獲取日曆的ID，以便將事件添加到正確的日曆中。可以通過以下代碼獲取日曆ID：

private static long getCalendarID(Context context) {
    String[] projection = {CalendarContract.Calendars._ID};
    Cursor cursor = context.getContentResolver().query(
            CalendarContract.Calendars.CONTENT_URI,
            projection,
            CalendarContract.Calendars.ACCOUNT_NAME + "=? AND " + CalendarContract.Calendars.ACCOUNT_TYPE + "=?",
            new String[]{ACCOUNT_NAME, ACCOUNT_TYPE},
            null);

    if (cursor != null && cursor.moveToFirst()) {
        long id = cursor.getLong(0);
        cursor.close();
        return id;
    } else {
        return -1;
    }
}

其中，ACCOUNT_NAME和ACCOUNT_TYPE用於過濾特定的日曆賬戶，可以根據需要進行修改。

三、創建日曆事件

使用獲取到的日曆ID，可以通過以下代碼創建日曆事件：

private static void createEvent(Context context, String title, long startMillis, long endMillis) {
    ContentResolver cr = context.getContentResolver();
    ContentValues values = new ContentValues();
    values.put(CalendarContract.Events.TITLE, title);
    values.put(CalendarContract.Events.DTSTART, startMillis);
    values.put(CalendarContract.Events.DTEND, endMillis);
    values.put(CalendarContract.Events.CALENDAR_ID, getCalendarID(context));
    values.put(CalendarContract.Events.EVENT_TIMEZONE, TimeZone.getDefault().getID());
    Uri uri = cr.insert(CalendarContract.Events.CONTENT_URI, values);
}

其中，title表示事件標題，startMillis和endMillis分別表示事件的開始和結束時間（以毫秒為單位），CALENDAR_ID表示日曆ID，EVENT_TIMEZONE表示時區。

四、完整代碼示例

下面是一個完整的示例代碼，可以通過該代碼創建一個名稱為「測試事件」的日曆事件，開始時間為當前時間，結束時間為當前時間加10分鐘：

public class MainActivity extends AppCompatActivity {

    private static final String ACCOUNT_NAME = "my_account_name";
    private static final String ACCOUNT_TYPE = "my_account_type";

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        createEvent(this, "測試事件", System.currentTimeMillis(), System.currentTimeMillis() + 10 * 60 * 1000);
    }

    private static long getCalendarID(Context context) {
        String[] projection = {CalendarContract.Calendars._ID};
        Cursor cursor = context.getContentResolver().query(
                CalendarContract.Calendars.CONTENT_URI,
                projection,
                CalendarContract.Calendars.ACCOUNT_NAME + "=? AND " + CalendarContract.Calendars.ACCOUNT_TYPE + "=?",
                new String[]{ACCOUNT_NAME, ACCOUNT_TYPE},
                null);

        if (cursor != null && cursor.moveToFirst()) {
            long id = cursor.getLong(0);
            cursor.close();
            return id;
        } else {
            return -1;
        }
    }

    private static void createEvent(Context context, String title, long startMillis, long endMillis) {
        ContentResolver cr = context.getContentResolver();
        ContentValues values = new ContentValues();
        values.put(CalendarContract.Events.TITLE, title);
        values.put(CalendarContract.Events.DTSTART, startMillis);
        values.put(CalendarContract.Events.DTEND, endMillis);
        values.put(CalendarContract.Events.CALENDAR_ID, getCalendarID(context));
        values.put(CalendarContract.Events.EVENT_TIMEZONE, TimeZone.getDefault().getID());
        Uri uri = cr.insert(CalendarContract.Events.CONTENT_URI, values);
    }
}

五、總結

通過Android日曆API，我們可以方便地在應用中創建自定義的日曆事件，只需要獲取日曆ID和填寫必要的字段即可。在實際開發中，可以根據需要進行事件的編輯和刪除操作，以滿足用戶的各種需求。