使用python生成ical日歷文件——將課程表導入到手機日歷

　　ics文件是日歷軟件中很常見的格式，可以將日歷賬戶中的日程安排導出成.ics文件，也可以將.ics文件中的事件導入到日歷中。那么我們如何使用python來生成Ics文件呢？我們可以先找一個ics文件，用文本的方式來打開這個文件，看看一個,ics文件里都包含了那些信息，我們使用python拼湊出相同格式的信息，寫入文本文件並且使用ics后綴結尾不就可以了嗎？

這是我在日歷中創建日程事件之后導出的.ics文件中的片段：

 

BEGIN:VCALENDAR
PRODID:-//ZHONG_BAI_REN//APPGENIX-SOFTWARE//
VERSION:2.0
CALSCALE:GREGORIAN
METHOD:PUBLISH
X-WR-CALNAME:my_schedule
X-WR-TIMEZONE:null
BEGIN:VEVENT
SUMMARY:工程電磁場
ORGANIZER;CN=My Calendar:mailto:[e-mail]
DTSTART;TZID=Asia/Shanghai:20190513T082000
DTEND;TZID=Asia/Shanghai:20190513T095500
DTSTAMP:20190221T202219Z
UID:[e-mail]
SEQUENCE:0
CREATED:20190221T202219Z
DESCRIPTION:李風從-主講
LAST-MODIFIED:20190221T202219Z
LOCATION:2-006
STATUS:CONFIRMED
TRANSP:OPAQUE
END:VEVENT
END:VCALENDAR

　　從這個代碼片段就可以看出ics文件的大致結構，文件以BEGIN:VCALENDAR開頭，END:VCALENDAR結尾，事件以BEGIN:VEVENT開頭，以END:VEVENT結尾。仔細查看了各個字段名稱和字段后面的內容后可以猜知道
每個字段的含義，再根據每個字段的含義來編寫python代碼。
　　貼上代碼：

import datetime,os

class Event:
    """
    事件對象
    """
    def __init__(self,kwargs):
        self.event_data = kwargs

    def __turn_to_string__(self):
        self.event_text = "BEGIN:VEVENT\n"
        for item,data in self.event_data.items():
            item = str(item).replace("_","-")
            if item not in ["ORGANIZER","DTSTART","DTEND"]:
                self.event_text += "%s:%s\n"%(item,data)
            else:
                self.event_text += "%s;%s\n"%(item,data)
        self.event_text += "END:VEVENT\n"
        return self.event_text

class Calendar:
    """
    日歷對象
    """
    def __init__(self,calendar_name="My Calendar"):
        self.__events__ = {}
        self.__event_id__ = 0
        self.calendar_name = calendar_name

    def add_event(self,**kwargs):
        event = Event(kwargs)
        event_id = self.__event_id__
        self.__events__[self.__event_id__] = event
        self.__event_id__ += 1
        return event_id

    def modify_event(self,event_id,**kwargs):
        for item,data in kwargs.items():
            self.__events__[event_id].event_data[item] = data
    
    def remove_event(self,event_id):
        self.__events__.pop(event_id)
    
    def get_ics_text(self):
        self.__calendar_text__ = """BEGIN:VCALENDAR\nPRODID:-//ZHONG_BAI_REN//APPGENIX-SOFTWARE//\nVERSION:2.0\nCALSCALE:GREGORIAN\nMETHOD:PUBLISH\nX-WR-CALNAME:%s\nX-WR-TIMEZONE:null\n"""%self.calendar_name
        for key,value in self.__events__.items():
            self.__calendar_text__ += value.__turn_to_string__()
        self.__calendar_text__ += "END:VCALENDAR"
        return self.__calendar_text__
    
    def save_as_ics_file(self):
        ics_text = self.get_ics_text()
        open("%s.ics"%self.calendar_name,"w",encoding="utf8").write(ics_text)#使用utf8編碼生成ics文件，否則日歷軟件打開是亂碼

    def open_ics_file(self):
        os.system("%s.ics"%self.calendar_name)

def add_event(cal, SUMMARY, DTSTART, DTEND, DESCRIPTION, LOCATION):
    """
    向Calendar日歷對象添加事件的方法
    :param cal: calender日歷實例
    :param SUMMARY: 事件名
    :param DTSTART: 事件開始時間
    :param DTEND: 時間結束時間
    :param DESCRIPTION: 備注
    :param LOCATION: 時間地點
    :return:
    """
    time_format = "TZID=Asia/Shanghai:{date.year}{date.month:0>2d}{date.day:0>2d}T{date.hour:0>2d}{date.minute:0>2d}00"
    dt_start = time_format.format(date=DTSTART)
    dt_end = time_format.format(date=DTEND)
    create_time = datetime.datetime.today().strftime("%Y%m%dT%H%M%SZ")
    cal.add_event(
        SUMMARY=SUMMARY,
        ORGANIZER="CN=My Calendar:mailto:[e-mail]",
        DTSTART=dt_start,
        DTEND=dt_end,
        DTSTAMP=create_time,
        UID="{}[e-mail]".format(create_time),
        SEQUENCE="0",
        CREATED=create_time,
        DESCRIPTION=DESCRIPTION,
        LAST_MODIFIED=create_time,
        LOCATION=LOCATION,
        STATUS="CONFIRMED",
        TRANSP="OPAQUE"
    )

if __name__ == '__main__':
    calendar = Calendar(calendar_name="test")
    add_event(calendar,
              SUMMARY="測試",
              DTSTART=datetime.datetime(year=2019,month=2,day=19,hour=21,minute=21,second=00),
              DTEND=datetime.datetime(year=2019,month=2,day=19,hour=21,minute=30,second=00),
              DESCRIPTION="測試事件",
              LOCATION="我也不知道在哪兒")
    print(calendar.get_ics_text())
    calendar.save_as_ics_file()

 代碼的使用方法：

　　1.創建Calendar日歷對象，傳入可選參數“calendar_name”（同時也是生成的ics文件名，不傳入則為默認值“My Calendar”）
　　2.調用add_event方法，第一個參數傳入上一步的Calendar實例，然后依次傳入
　　　　
　　　　參數作用　　 參數名　　　　 參數類型
　　　　日歷對象　　 cal　　　　　　Calender對象
　　　　事件名稱 　　SUMMARY　　　　字符串類型
　　　　事件開始時間 DTSTART　　　　datetime類型
　　　　事件結束時間 DTEND　　　　　datetime類型
　　　　事件發生地點 LOCATION　　　 字符串類型
　　　　事件備注 　　DESCRIPTION　　字符串類型
　　3.調用Calendar實例的save_as_ics_file()方法，即可在代碼的工作目錄里生成一個ics文件
　　4.使用電腦或者手機等的日歷軟件的導入功能，即可將事件導入到日歷的日程中。