結論

ICSファイル(.ics)は、予定の日時・件名・場所・繰り返しを書いた、iCalendar(RFC 5545)という共通の形式のテキストファイルです。Googleカレンダーならパソコンの「設定」→「インポート / エクスポート」、Outlook.comなら「予定表の追加」→「ファイルからアップロード」、Macのカレンダーなら「ファイル」→「読み込む」で取り込めます。

この記事でわかること

  • Google・Outlook・iPhone・Mac・Androidへの取り込み方と、URLで購読する方法との違い
  • PythonでICSを作って読み戻した実物(先頭のバイト・折り返し・繰り返しの展開)
  • 時刻が9時間ずれる・文字化けする原因を、3通りの時刻の書き方で再現した結果

2026年11月13日更新|Python 3.13・icalendar 7.3.0・python-dateutil 4.0.0で実行確認

この記事で実際に動かしたもの:Python の標準ライブラリだけで ICS ファイルを作り、icalendar で読み戻して中身と繰り返しの展開を確かめ、タイムゾーンの書き方3通りで時刻がどう解釈されるかを比べました。

flowchart TD
    F[ICSファイル] --> I[取り込む]
    U[ICSのURL] --> S[購読する]
    I --> C1[その時点のコピー<br>更新されない]
    S --> C2[元の変更が<br>反映される]
    C1 --> Q{時刻は合う?}
    C2 --> Q
    Q -->|ずれる| T[Zと<br>TZIDを見る]
    Q -->|合う| OK[完了]

よく調べられることの答えを先にまとめます。

知りたいこと 答え 詳しい節
icsファイルとは 予定を書いた iCalendar 形式のテキスト。MIME は text/calendar ICSファイルとは
ics 取り込み(Googleカレンダー) パソコンで「設定」→「インポート / エクスポート」→「インポート」 Googleカレンダーへの取り込み方
ics 取り込み(Outlook) Outlook.com は「ファイルからアップロード」、従来の Outlook はインポートとエクスポート ウィザード Outlookへの取り込み方
ics 取り込み(iPhone) URL なら「照会カレンダーを追加」。ファイルは Mac や Google で取り込んで同期 iPhone・Mac・Androidでの取り込み方
取り込みと購読の違い 取り込みはその時点のコピー。購読は元の変更が反映される 取り込みとURLで購読の違い
icsファイルの作り方 BEGIN:VCALENDAR から書き、VEVENT に UID・DTSTAMP・DTSTART を入れる ICSファイルの作り方
時刻が9時間ずれる 日本時間の値に末尾の Z(UTC)を付けている。TZID で書く 時刻がずれる原因
文字化けする UTF-8 以外で保存している。UTF-8 で保存し直す 文字化け・読み込めない原因

確認環境:Ubuntu 24.04.5 LTS の上で、Python 3.13.18 の標準ライブラリだけを使って ICS ファイルを作り、icalendar 7.3.0 で読み戻しました。繰り返し(RRULE)の展開は python-dateutil 4.0.0、タイムゾーンは Python の zoneinfo(tzdata 2026.6)で計算しています。ファイルの種類の判定は file 5.45、先頭のバイトは od(GNU coreutils 9.4)で表示しました。Google カレンダー・Outlook・iPhone・Mac・Android の画面は手元では操作しておらず、ログインもしていません。各社の公式ヘルプ(Google カレンダー ヘルプ、Microsoft サポート、Apple サポート)で手順と名前を確かめた範囲だけを書いています。形式の決まりは RFC 5545 の原文で確かめました。図は mermaid で描画を確かめています(確認日 2026年11月13日)。

本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。

(記載例)出典:株式会社RJC「ICSファイルとは|Google・Outlook・iPhoneへの取り込み方と作り方」

ICSファイルとは(iCalendar・RFC 5545の意味)

この節では、ICSファイルが何のファイルで、どこで使われているのかが分かります。

ICSファイルは、カレンダーの予定をアプリ同士で受け渡すための、iCalendar 形式のテキストファイルです。 形式は IETF の RFC 5545「Internet Calendaring and Scheduling Core Object Specification (iCalendar)」で決められていて、メディアタイプは text/calendar、拡張子は .ics と同じ RFC の 8.1 節に登録されています。同じ節で、空き時間(free/busy)の情報を入れたファイルには .ifb を使うことも決められています。

中身は文字だけなので、メモ帳などのテキストエディターでも読めます。Google カレンダー・Outlook・Apple のカレンダーのように、メーカーの違うアプリの間で予定を渡せるのは、どれもこの共通の形式を読み書きできるからです。

1メールの会議の招待

会議の招待メールに付く invite.ics などの添付。開くと予定の追加や出欠の返事ができるアプリが多い。

2イベント・セミナーの「カレンダーに追加」

申し込み後のページやメールにある、予定1件分の ICS ファイル。

3祝日・行事・時間割の配布

年間の予定をまとめた ICS ファイルや、更新され続ける ICS の URL(購読用)。

4カレンダーの引っ越し・控え

Google カレンダーや Mac のカレンダーから書き出し、別のアプリへ取り込む。

ICS・iCalendar・iCal の呼び方の違い

呼び方 指しているもの
iCalendar 形式の名前(RFC 5545)。VERSION:2.0 と書く
ICS・.ics その形式で保存したファイルの拡張子
iCal RFC 5545 の 8.1 節にある Macintosh のファイルタイプコード。iCalendar の略として使われることもある
text/calendar Web サーバーやメールでこのファイルを送るときの MIME タイプ

このファイルを受け取ったときの注意

ICS ファイルは文字だけのファイルですが、出所の分からないメールに付いてきたものは、開く前に送り主に確かめます。取り込むと、件名や説明に書かれた URL がカレンダーに並ぶことになるためです。

ICSファイルの中身(マジックナンバーと構造を実物で)

この節では、ICS ファイルの先頭のバイトと、中の構造が実物で分かります。

Python の標準ライブラリだけで作った見本(予定2件・894バイト)の先頭32バイトを od で16進表示すると、次のようになりました。

$ od -A x -t x1z -N 32 sample.ics
000000 42 45 47 49 4e 3a 56 43 41 4c 45 4e 44 41 52 0d  >BEGIN:VCALENDAR.<
000010 0a 56 45 52 53 49 4f 4e 3a 32 2e 30 0d 0a 50 52  >.VERSION:2.0..PR<
000020
$ file sample.ics
sample.ics: iCalendar calendar file
$ file --mime-type sample.ics
sample.ics: text/calendar

ICS ファイルの先頭は、文字の「BEGIN:VCALENDAR」(16進で 42 45 47 49 4E 3A 56 43 41 4C 45 4E 44 41 52)です。 画像や ZIP のような特別なバイト列(マジックナンバー)ではなく、この文字列そのものが目印になります。file コマンドもこの文字列を見て「iCalendar calendar file」と判定しました。行の終わりが 0d 0a(CR と LF)になっているのは、RFC 5545 の 3.1 節が「行は CRLF で区切る」と決めているためです。

入れ子の構造

ICS ファイルは BEGIN:〇〇 と END:〇〇 で囲んだ「コンポーネント」の入れ子です。各行は 名前;パラメーター:値 の形をしています。

コンポーネント 入るもの 主な項目
VCALENDAR ファイル全体(1つ) VERSION(2.0)・PRODID(作ったソフト)
VTIMEZONE TZID で使うタイムゾーンの定義 TZID・TZOFFSETFROM・TZOFFSETTO
VEVENT 予定1件ごと UID・DTSTAMP・DTSTART・DTEND・SUMMARY・RRULE
VALARM VEVENT の中の通知 ACTION・TRIGGER(例:-PT10M=10分前)
VTODO・VJOURNAL やること・日誌(予定以外) DUE・STATUS など

作った見本を icalendar で読み戻すと、件名・場所・説明の中のカンマやセミコロン、改行が元どおりに戻りました。

== 先頭16バイト
42 45 47 49 4E 3A 56 43 41 4C 45 4E 44 41 52 0D | BEGIN:VCALENDAR
== 折り返しの行(先頭が空白)
23 73 octets  す。オンライン参加の方は案内のURLか ...
== 読み戻し(icalendar 7.3.0)
SUMMARY  : 週次の定例(開発チーム)
LOCATION : 会議室A, 3階
DTSTART  : datetime.datetime(2026, 11, 24, 10, 0, tzinfo=zoneinfo.ZoneInfo(key='Asia/Tokyo'))
DTEND    : datetime.datetime(2026, 11, 24, 10, 30, tzinfo=zoneinfo.ZoneInfo(key='Asia/Tokyo')) / 長さ 0:30:00
DESCRIPTION: '議題: 進捗; 課題\n資料は前日までに共有します。オンライン参加の方は案内のURLから入室します。'
RRULE    : FREQ=WEEKLY;COUNT=6;BYDAY=TU,TH
    2026-11-24 (Tue) 10:00 JST
    2026-11-26 (Thu) 10:00 JST
    2026-12-01 (Tue) 10:00 JST
    2026-12-03 (Thu) 10:00 JST
    2026-12-08 (Tue) 10:00 JST
    2026-12-10 (Thu) 10:00 JST

SUMMARY  : 研修(3日間)
LOCATION :
DTSTART  : datetime.date(2026, 12, 2)
DTEND    : datetime.date(2026, 12, 5) / 長さ 3 days, 0:00:00

1長い行は折り返される

説明の行は73バイトで切られ、次の行が空白1つで始まった。RFC 5545 は1行を75バイト以下にすることを勧めている。

2記号は「\」で守られる

ファイルの中では 会議室A\, 3階。読み戻すと「会議室A, 3階」に戻った。

3繰り返しは1件で書く

RRULE の1行から、火曜と木曜の6回分が展開された。

Googleカレンダーへの取り込み方(ICSのインポート)

この節では、ICS ファイルを Google カレンダーに取り込む手順と、スマホでの扱いが分かります。

Google カレンダーへの ICS の取り込みは、パソコンのブラウザで行います。 Google カレンダー ヘルプには、ICS と CSV のファイルはパソコンで取り込める、と書かれています。

1

パソコンで Google カレンダーを開く

ブラウザで Google カレンダーを開き、右上の設定のアイコンから「設定」を選びます。

パソコン

2

「インポート / エクスポート」を開く

左側のメニューで「インポート / エクスポート」を選びます。

左のメニュー

3

ファイルを選ぶ

「パソコンからファイルを選択」で .ics ファイルを選びます。

.ics・.csv

4

追加先のカレンダーを選んで「インポート」

取り込み先のカレンダーを選びます(既定はメインのカレンダー)。仕事用と個人用を分けているなら、ここで選び直します。

取り込み先

  • 予定のゲストと会議のデータは取り込まれません(Google カレンダー ヘルプの記載)。
  • 複数の .ics が入った ZIP は、展開してから1つずつ取り込みます。 Google カレンダーから書き出したファイルは ZIP にまとまっています。
  • 取り込んだ予定は、元のファイルとは同期されません。元が変わる予定は、次の節の「URL で購読」を使います。

Android や iPhone の Google カレンダー アプリには、ファイルを取り込む手順は公式ヘルプに載っていません。パソコンで取り込んだ予定は、同じ Google アカウントでログインしているスマホのアプリにも表示されます。

Outlookへの取り込み方(Outlook.com・従来のOutlook)

この節では、Outlook の種類ごとに ICS を取り込む手順が分かります。

Outlook は種類によって入口が違います。 Microsoft サポートで手順を確かめられたのは、Outlook.com(Outlook on the web)と、従来の Windows 版 Outlook の2つです。

Outlook.com・Outlook on the web

ナビゲーション ウィンドウで予定表を開き「予定表の追加」

「ファイルからアップロード」→「参照」で .ics を選び「開く」

取り込み先の予定表を選んで「インポート」

従来の Outlook(Windows)

「ファイル」→「開く & エクスポート」→ インポートとエクスポート

ウィザードで「iCalendar (.ics) または vCalendar ファイル (.vcs) をインポートする」

ファイルを選び、新しい予定表として開くか取り込むかを選ぶ

Outlook.com で「予定表の追加」が見当たらないときは、予定表の上部の三本線のアイコンでナビゲーション ウィンドウを広げます(Microsoft サポートの記載)。新しい Outlook for Windows の手順は、確認日に読んだ公式ページには載っていなかったため、この記事では書いていません。

Microsoft サポートは、取り込んだ予定について「元の予定表の持ち主が変更しても、自動では更新されない」と説明しています。変わらない予定(潮の満ち引きの表など)は取り込み、よく変わる予定(上映の時間・学校の行事など)は購読が向いている、という使い分けも同じページにあります。

iPhone・Mac・Androidでの取り込み方

この節では、Apple の端末と Android で ICS を使う方法が、公式の手順で分かります。

Mac のカレンダー

Mac のカレンダーは「ファイル」→「読み込む」で .ics を選ぶか、ファイルをカレンダーのウインドウへドラッグします。 読み込んだあと、追加先のカレンダーを選んで「OK」をクリックします(Apple の「Mac用カレンダーユーザガイド」)。同じページには、.ics を読み込むと以前のカスタムカラーが消えること、すべてのカレンダーをまとめて扱うときは .icbu のアーカイブを使うことも書かれています。

iPhone のカレンダー

Apple の「iPhoneユーザガイド」で確かめられたのは、URL で読む「照会カレンダー」と、.ics へのリンクをタップする方法です。

  1. カレンダーアプリで、カレンダーのボタンをタップし「カレンダーを追加」をタップします。
  2. 「照会カレンダーを追加」をタップします。
  3. 照会したい .ics ファイルの URL などを入力し「検索」をタップします。

手元にある .ics ファイルそのものを iPhone で取り込む手順は、確認日に読んだ iPhone ユーザガイドには載っていませんでした。公式の手順だけでつなぐなら、Mac のカレンダーで読み込むときに追加先として iCloud のカレンダーを選ぶ方法か、パソコンで Google カレンダーに取り込み、その Google アカウントを iPhone のカレンダーで表示する方法になります。

Android

Android の Google カレンダー アプリでの取り込みは、Google の公式ヘルプでは案内されていません。パソコンのブラウザで Google カレンダーに取り込むと、同じアカウントの Android にも表示されます。

OS別の早見表

端末 ファイルの取り込み URL で購読
Windows 従来の Outlook のウィザード/ブラウザで Google・Outlook.com ブラウザで Google「URL で追加」・Outlook.com「Web からサブスクライブ」
Mac カレンダーの「ファイル」→「読み込む」 ブラウザで Google・Outlook.com
iPhone 公式の手順なし(Mac・Google 経由) 「照会カレンダーを追加」・.ics のリンクをタップ
Android 公式の手順なし(パソコンの Google 経由) Google はパソコンのブラウザで登録
Linux ブラウザで Google・Outlook.com ブラウザで Google・Outlook.com

ICSの取り込みとURLで購読の違い

この節では、ファイルを取り込むのと URL で購読するのと、どちらを選べばよいかが分かります。

取り込みは「その時点の予定のコピー」、購読は「元のカレンダーを読み続ける」方法です。 同じ ICS の形式でも、ファイルで渡すか URL で渡すかで動きが変わります。

比べる点 ファイルの取り込み URL で購読
元の変更 反映されない 反映される
予定の編集 自分のカレンダーの予定として編集できる 読むだけ(元を直す)
反映の間隔 取り込んだ瞬間だけ Outlook.com はおよそ3時間ごと、24時間以上かかることもある(Microsoft)。Google は公式ヘルプに記載なし
スマホでの登録 Google はパソコンのみ Google はパソコンのブラウザのみ。iPhone は「照会カレンダーを追加」
向いている予定 会議1件・研修の日程・控え 祝日・行事・時間割・チームの予定表

よく変わる予定表を配るとき

避けたい変更のたびに .ics ファイルをメールで配り直す。受け取った側に変更前と変更後の予定が二重に残りやすい
→
代わりにICS の URL を1つ決めて購読してもらう。配る側は URL の中身だけを更新する

見分ける問い:「この予定は配ったあとに変わるか」

Google カレンダーの「URL で追加」は、左側の「他のカレンダー」の横のアイコンから選び、公開されたカレンダーの URL を入れて「カレンダーを追加」をクリックします。Google のヘルプには、この方法で追加できるのは相手のカレンダーが一般公開されている場合だけ、と書かれています。

ICSファイルの作り方(Pythonと項目の意味)

この節では、ICS ファイルを自分で作る方法と、必ず入れる項目が分かります。

ICS はテキストなので、決まった項目を CRLF の改行で並べれば作れます。 次のコードは、標準ライブラリだけで、週2回の定例(6回)と3日間の研修の2件を書き出したものです。実行すると894バイト、いちばん長い行は73バイトでした。

import sys, uuid, datetime as dt

def esc(s):
    # TEXT の値では \ ; , と改行をエスケープする(RFC 5545 3.3.11)
    return (s.replace('\\', '\\\\').replace(';', '\\;')
             .replace(',', '\\,').replace('\n', '\\n'))

def fold(line):
    # 75バイトを超える行を、文字の途中で切らずに折り返す(RFC 5545 3.1)
    out, cur = [], b''
    for ch in line:
        cb = ch.encode('utf-8')
        if len(cur) + len(cb) > 75:
            out.append(cur)
            cur = b' ' + cb
        else:
            cur += cb
    out.append(cur)
    return b'\r\n'.join(out)

stamp = dt.datetime.now(dt.timezone.utc).strftime('%Y%m%dT%H%M%SZ')
lines = [
    'BEGIN:VCALENDAR', 'VERSION:2.0', 'PRODID:-//example//ics-sample//JA',
    'CALSCALE:GREGORIAN',
    'BEGIN:VTIMEZONE', 'TZID:Asia/Tokyo', 'BEGIN:STANDARD',
    'DTSTART:19700101T000000', 'TZOFFSETFROM:+0900', 'TZOFFSETTO:+0900',
    'TZNAME:JST', 'END:STANDARD', 'END:VTIMEZONE',
    'BEGIN:VEVENT',
    'UID:' + str(uuid.uuid5(uuid.NAMESPACE_URL, 'sample/weekly')) + '@example.com',
    'DTSTAMP:' + stamp,
    'DTSTART;TZID=Asia/Tokyo:20261124T100000',
    'DTEND;TZID=Asia/Tokyo:20261124T103000',
    'RRULE:FREQ=WEEKLY;BYDAY=TU,TH;COUNT=6',
    'SUMMARY:' + esc('週次の定例(開発チーム)'),
    'LOCATION:' + esc('会議室A, 3階'),
    'DESCRIPTION:' + esc('議題: 進捗; 課題\n資料は前日までに共有します。'
                         'オンライン参加の方は案内のURLから入室します。'),
    'END:VEVENT',
    'BEGIN:VEVENT',
    'UID:' + str(uuid.uuid5(uuid.NAMESPACE_URL, 'sample/allday')) + '@example.com',
    'DTSTAMP:' + stamp,
    'DTSTART;VALUE=DATE:20261202', 'DTEND;VALUE=DATE:20261205',
    'SUMMARY:' + esc('研修(3日間)'),
    'END:VEVENT',
    'END:VCALENDAR',
]
data = b'\r\n'.join(fold(l) for l in lines) + b'\r\n'
open(sys.argv[1], 'wb').write(data)

必ず入れる項目と、よく使う項目

項目 意味 決まり(RFC 5545)
VERSION・PRODID 形式の版(2.0)と、作ったソフトの名前 VCALENDAR に必須
UID 予定の世界で1つの ID VEVENT に必須。ドメイン名を含めて作ることが勧められている
DTSTAMP この情報を作った日時(UTC) VEVENT に必須
DTSTART・DTEND 開始と終了。DTEND の時刻はその予定に含まれない DTEND の代わりに DURATION(例:PT30M)も使える
SUMMARY・LOCATION・DESCRIPTION 件名・場所・説明 \ ; , と改行は「\」を付けて書く
RRULE 繰り返しの規則 FREQ が必須。COUNT と UNTIL は同時に使わない
SEQUENCE 変更の回数 作成時は0。主催者が大事な変更をするたびに増やす

ライブラリで作る(icalendar)

手で書くと、エスケープ・折り返し・VTIMEZONE を忘れがちです。icalendar を使うと、Python の datetime を渡すだけで正しい形に書き出され、add_missing_timezones() で VTIMEZONE も足されました。次は、毎月最終金曜の15時に3回、10分前の通知つきの予定を作った例です。

import datetime as dt
from zoneinfo import ZoneInfo
import icalendar

cal = icalendar.Calendar()
cal.add('prodid', '-//example//ics-sample//JA')
cal.add('version', '2.0')
ev = icalendar.Event()
ev.add('uid', 'release-review-20261127@example.com')
ev.add('dtstamp', dt.datetime(2026, 11, 13, 0, 0, tzinfo=dt.timezone.utc))
ev.add('dtstart', dt.datetime(2026, 11, 27, 15, 0, tzinfo=ZoneInfo('Asia/Tokyo')))
ev.add('dtend', dt.datetime(2026, 11, 27, 16, 0, tzinfo=ZoneInfo('Asia/Tokyo')))
ev.add('summary', 'リリース前レビュー')
ev.add('rrule', {'freq': 'monthly', 'byday': '-1FR', 'count': 3})
alarm = icalendar.Alarm()
alarm.add('action', 'DISPLAY')
alarm.add('description', 'まもなく開始')
alarm.add('trigger', dt.timedelta(minutes=-10))
ev.add_component(alarm)
cal.add_component(ev)
cal.add_missing_timezones()
open('lib.ics', 'wb').write(cal.to_ical())
BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//example//ics-sample//JA
BEGIN:VTIMEZONE
TZID:Asia/Tokyo
COMMENT:This timezone only works from 1970-01-01 to 2038-01-01.
BEGIN:STANDARD
DTSTART:19700101T000000
TZNAME:JST
TZOFFSETFROM:+0900
TZOFFSETTO:+0900
END:STANDARD
END:VTIMEZONE
BEGIN:VEVENT
SUMMARY:リリース前レビュー
DTSTART;TZID=Asia/Tokyo:20261127T150000
DTEND;TZID=Asia/Tokyo:20261127T160000
DTSTAMP:20261113T000000Z
UID:release-review-20261127@example.com
RRULE:FREQ=MONTHLY;COUNT=3;BYDAY=-1FR
BEGIN:VALARM
ACTION:DISPLAY
DESCRIPTION:まもなく開始
TRIGGER:-PT10M
END:VALARM
END:VEVENT
END:VCALENDAR

展開すると 2026-11-27・2026-12-25・2027-01-29 の15時(日本時間)になりました。足された VTIMEZONE には「1970年から2038年まで有効」という COMMENT が入っています。日本時間には夏時間が無いので、この範囲の予定なら影響はありません。

Web サイトで配るとき

サーバーから返すときは Content-Type: text/calendar; charset=utf-8 を付けます。RFC 5545 は文字コードを UTF-8 と決めていて、アプリは UTF-8 と US-ASCII を受け付けなければならない、としています。予定の内容を後から直して配り直すときは、UID を変えずに、SEQUENCE を1つ増やします。UID を変えると別の予定として扱われ、二重に残る原因になります。

ICSの時刻がずれる原因(タイムゾーンとUTCのZ)

この節では、取り込んだ予定の時刻がずれる理由が、3通りの書き方を比べた結果で分かります。

RFC 5545 の日時には、Z も TZID も付けない「浮動」、末尾に Z を付けた「UTC」、TZID で地域を示す書き方の3つがあります。 同じ「11月20日の日本時間10時」のつもりで4通り書き、icalendar で読み戻して、東京・ロサンゼルス・ロンドンの時刻に直しました。

| 書き方 | 読み戻した値 | Asia/Tokyo | America/Los_Angeles | Europe/London |
| A 浮動(Zなし・TZIDなし) | 2026-11-20T10:00:00 | 11/20 10:00 | 11/20 10:00 | 11/20 10:00 |
| B UTC(末尾Z) | 2026-11-20T01:00:00+00:00 | 11/20 10:00 | 11/19 17:00 | 11/20 01:00 |
| C TZID=Asia/Tokyo | 2026-11-20T10:00:00+09:00 | 11/20 10:00 | 11/19 17:00 | 11/20 01:00 |
| D 誤り:JSTの10時にZ | 2026-11-20T10:00:00+00:00 | 11/20 19:00 | 11/20 02:00 | 11/20 10:00 |
書き方 ファイルの1行 起きること
A 浮動 DTSTART:20261120T100000 見る人の端末の時刻でいつも10:00。海外の人とずれる
B UTC DTSTART:20261120T010000Z どこでも同じ瞬間。日本時間から9時間引いて書く
C TZID TZID=Asia/Tokyo を付けて 100000 どこでも同じ瞬間。日本時間のまま書ける
D 誤り DTSTART:20261120T100000Z 日本では19:00と表示。9時間ずれる

「9時間遅れて表示される」のは、日本時間の数字に Z を付けてしまった D の形がほとんどです。 RFC 5545 は、UTC の値に TZID を付けてはならないとも決めています。また、TZID を使うときは、ファイルの中に同じ名前の VTIMEZONE を入れることになっています。上の見本で VTIMEZONE を入れたのはそのためです。

夏時間のある地域の繰り返し

米国東部の「毎週9時」の会議を、TZID で書いた場合と UTC(Z)で固定した場合で比べました。2027年は3月14日に夏時間が始まります。

== 夏時間をまたぐ繰り返し(TZID=America/New_York 毎週 9:00)
2027-03-01 09:00 EST -> UTC 14:00 -> JST 03-01 23:00
2027-03-08 09:00 EST -> UTC 14:00 -> JST 03-08 23:00
2027-03-15 09:00 EDT -> UTC 13:00 -> JST 03-15 22:00
== 同じものを UTC 固定(Z)で毎週 14:00Z にした場合
2027-03-01 14:00Z -> New York 09:00 EST
2027-03-08 14:00Z -> New York 09:00 EST
2027-03-15 14:00Z -> New York 10:00 EDT

TZID で書くと、現地ではいつも9時のまま、日本時間では23時から22時に変わります。UTC で固定すると、現地では10時に変わってしまいます。繰り返しの予定は TZID で書くのが、現地の時刻を守る書き方です。

サーバーやデータベースの側で時刻がずれる話は、関連記事「日時が9時間ずれる原因と直し方|Java・JS・MySQL・PG・Docker」で扱っています。UTC で保存して日本時間で表示する設計は、関連記事「タイムゾーン設計|UTC保存・JST表示をDB別実行結果で解説」で扱っています。

繰り返し予定の書き方(RRULE)と終日予定

この節では、RRULE の書き方の例と、終日・複数日の予定で日付がずれない書き方が分かります。

RRULE は「FREQ(頻度)」に、回数(COUNT)か終わり(UNTIL)、曜日(BYDAY)や日(BYMONTHDAY)を組み合わせて書きます。 python-dateutil で実際に展開した結果です。

やりたいこと RRULE 展開した結果(開始日から)
毎週火・木を6回 FREQ=WEEKLY;BYDAY=TU,TH;COUNT=6 11/24・11/26・12/01・12/03・12/08・12/10
毎月第2月曜を4回 FREQ=MONTHLY;BYDAY=2MO;COUNT=4 2026-12-14・2027-01-11・02-08・03-08
毎月最終金曜を3回 FREQ=MONTHLY;BYDAY=-1FR;COUNT=3 2026-11-27・12-25・2027-01-29
毎月31日(4回) FREQ=MONTHLY;BYMONTHDAY=31;COUNT=4 12-31・01-31・03-31・05-31(31日の無い月は飛ばす)
毎月末日(4回) FREQ=MONTHLY;BYMONTHDAY=-1;COUNT=4 12-31・01-31・02-28・03-31
2日おきに12/10まで FREQ=DAILY;INTERVAL=2;UNTIL=… 12/01・03・05・07・09

「毎月31日」は、31日の無い月が飛ばされました。 月末に必ず入れたいなら BYMONTHDAY=-1(最後の日)と書きます。RFC 5545 も、存在しない日付になる回は数えずに無視する、と決めています。

繰り返しと例外日をアプリのデータベースでどう持つかは、関連記事「繰り返し予定のDB設計|RRULEと例外日のテーブル例とSQL」で扱っています。ICS の側では、1回だけ休む日は EXDATE、1回だけ時刻を変える日は同じ UID に RECURRENCE-ID を付けた VEVENT で表します。

終日・複数日の予定

終日の予定は VALUE=DATE で日付だけを書き、DTEND には「最終日の翌日」を書きます。 RFC 5545 は、DTEND を予定に含まれない終わり(non-inclusive)と決めているためです。見本の「12月2日〜4日の研修」は DTSTART;VALUE=DATE:20261202・DTEND;VALUE=DATE:20261205 で、読み戻すと長さは3日でした。DTEND を 20261204 と書くと、2日間の予定になります。DTSTART が日付だけで DTEND も DURATION も無いときは、1日の予定として扱われます。

  1. 1時刻が決まっている → TZID つきで書く会議・面談・リリース作業など
  2. 2世界中で同じ瞬間 → UTC(Z)でもよい配信の開始・メンテナンスの開始など繰り返さないもの
  3. 3日付だけ → VALUE=DATE祝日・締め切り日・研修の日程。DTEND は翌日
  4. 4どこでも現地の同じ時刻 → 浮動「毎朝7時に起きる」のような個人の予定だけ

ICSが文字化け・読み込めない原因

この節では、文字化けや「読み込めない」が起きる原因を、実際に壊したファイルで確かめた結果が分かります。

Shift_JIS で保存すると文字化けする

同じ見本を Shift_JIS で保存し、UTF-8 として読むと、件名の1バイト目でエラーになりました。置き換えて読むと文字化けした件名になります。

Shift_JIS のバイト: 8f 54 8e 9f 82 cc 92 e8 97 e1 81 69
UnicodeDecodeError: 'utf-8' codec can't decode byte 0x8f in position 8: invalid start byte
置き換えて読むと: SUMMARY:�T���̒��i�J���`�[���j

ICS の文字コードは UTF-8 です。 テキストエディターで手直ししたあと、保存時の文字コードが Shift_JIS(ANSI)になっていないかを確かめ、UTF-8 で保存し直します。文字化けのほかの原因は、関連記事「文字化けの原因8選|濁点分離・utf8mb4・絵文字の文字数」で扱っています。

75バイトで機械的に切ると、文字の途中で切れる

切れ目のバイト: 81 82 e3 81 82 e3
1行目だけ読むと UnicodeDecodeError: 'utf-8' codec can't decode byte 0xe3 in position 74: unexpected end of data
つなぎ直した結果: あああああ ...(つなげば元に戻る)

「あ」は UTF-8 で3バイトなので、75バイト目で切ると文字の途中になります。RFC 5545 は、単純な実装がこのような折り返しを作りうるので、読む側はバイト列としてつなぎ直して元に戻すように、と注意しています。icalendar はつなぎ直せましたが、書く側は上のコードの fold() のように文字の境目で切るのが安全です。

壊れたファイルを読んだときのエラー

END:VCALENDAR が無い -> ValueError: Found no components where exactly one is required: b'BEGIN:VCALENDAR\r\nVERSION:2.0\r\nPRO
BEGIN:VCALENDAR の綴り誤り -> 読めた VCALENDER VCALENDER
中身が HTML -> ValueError: Content line could not be parsed into parts: '<!DOCTYPE html><html><body>Not Found</body><

「中身が HTML」は、ICS の URL を開いたつもりが、エラーページやログイン画面の HTML を保存していた場合です。ファイルをテキストエディターで開き、1行目が BEGIN:VCALENDAR かを見るのがいちばん早い確かめ方です。綴りの誤り(VCALENDER)は icalendar では止まりませんでした。ライブラリが読めたことと、カレンダーアプリが受け付けることは別なので、1行目は目で確かめます。先頭に BOM(EF BB BF)が付いたファイルは、icalendar では2件とも読めました。

症状→原因→直し方

症状 原因 直し方
9時間遅れて表示される 日本時間の数字に Z が付いている Z を外して TZID=Asia/Tokyo を付けるか、9時間引く
見る人の国で時刻が変わらない Z も TZID も無い浮動の時刻 TZID を付ける
件名が文字化け Shift_JIS などで保存した UTF-8 で保存し直す
終日予定が1日短い DTEND に最終日を書いた DTEND を最終日の翌日にする
取り込むたびに予定が増える UID が毎回変わる 同じ予定には同じ UID を使う
ゲストが消えた Google はゲストと会議のデータを取り込まない 招待は元のアプリから送り直す
ファイルを選べない・読めない 中身が HTML・ZIP のまま・END が無い 1行目を確かめる。ZIP は展開する

ICSの変換(CSV・Googleカレンダー用)

この節では、ICS を CSV に変換する方法と、変換で失われるものが分かります。

ICS から CSV への変換は、Python で数十行で書けます。 Google カレンダー ヘルプにある CSV の見出し名(Subject・Start Date・Start Time・End Date・End Time・All Day Event・Description・Location・Private)に合わせて、見本の2件を変換しました。日付は MM/DD/YYYY、時刻は AM/PM の形です。

import csv, io, datetime as dt
import icalendar

cal = icalendar.Calendar.from_ical(open('sample.ics', 'rb').read())
out = io.StringIO()
w = csv.writer(out)
w.writerow(['Subject', 'Start Date', 'Start Time', 'End Date', 'End Time',
            'All Day Event', 'Location'])
for ev in cal.walk('VEVENT'):
    s, e = ev.decoded('DTSTART'), ev.decoded('DTEND')
    if isinstance(s, dt.datetime):
        w.writerow([ev['SUMMARY'], s.strftime('%m/%d/%Y'), s.strftime('%I:%M %p'),
                    e.strftime('%m/%d/%Y'), e.strftime('%I:%M %p'), 'False',
                    ev.get('LOCATION', '')])
    else:  # 終日:CSV の End Date は最終日にする
        w.writerow([ev['SUMMARY'], s.strftime('%m/%d/%Y'), '',
                    (e - dt.timedelta(days=1)).strftime('%m/%d/%Y'), '', 'True', ''])
print(out.getvalue())
Subject,Start Date,Start Time,End Date,End Time,All Day Event,Location
週次の定例(開発チーム),11/24/2026,10:00 AM,11/24/2026,10:30 AM,False,"会議室A, 3階"
研修(3日間),12/02/2026,,12/04/2026,,True,

1繰り返しが消える

CSV に RRULE の列は無い。6回の定例は1件目だけになった。Google のヘルプも、CSV の繰り返しの予定は繰り返しとして表示されないことがある、としている。

2タイムゾーンが消える

CSV の時刻は数字だけ。取り込む側のカレンダーのタイムゾーンで解釈される。

3終日の終わりの日の数え方が違う

ICS の DTEND は翌日、CSV の End Date は最終日。1日引いて合わせた。

カレンダー同士で予定を移すなら、CSV を通さず ICS のまま渡すほうが、繰り返し・タイムゾーン・通知が残ります。CSV は表で一覧したいときの出口と考えると迷いません。スプレッドシートの予定を Google カレンダーへ登録したいときは、関連記事「GASでGoogleカレンダーに予定を登録・取得|スプレッドシート一括登録」の方法もあります。

予定の数とファイルの大きさ

icalendar で1時間の予定を作り、件数とファイルの大きさを測りました。

予定の数 ファイルの大きさ 1件あたり
1件 452バイト 452バイト
10件 1,964バイト 196バイト
100件 17,264バイト 173バイト
1,000件 172,064バイト 172バイト

件名が短い予定なら、1,000件でも約170KBでした。最初の1件が大きいのは、VCALENDAR と VTIMEZONE の分が一度だけ乗るためです。

オンラインの変換サービスを使うとき

Web 上の変換サービスは、ファイルを外部に送ることになります。予定の件名・場所・説明には社外秘や個人の情報が入りやすいので、そうした予定を含むファイルは送らず、上のように手元で変換します。

似た形式との違い(vcs・vcf・ifb・CSV)

この節では、ICS と間違えやすいファイル形式との違いが分かります。

拡張子 形式 中身 ICS との関係
.ics iCalendar(RFC 5545) 予定・やること・通知 この記事の形式
.vcs vCalendar 予定 iCalendar の前の形式。従来の Outlook のウィザードは両方を取り込める
.vcf vCard 連絡先(名前・電話・メール) 予定ではない。カレンダーではなく連絡先アプリで開く
.ifb iCalendar(free/busy) 空き時間の情報 同じ RFC 5545 の 8.1 節で決められた拡張子
.csv カンマ区切りの表 1行1件の予定 繰り返し・タイムゾーンを持てない
.icbu Mac のカレンダーのアーカイブ すべてのカレンダー Mac のカレンダー同士で使う。ほかのアプリには .ics で渡す
  • 11行目が BEGIN:VCALENDAR か違えば ICS ではない(HTML・ZIP・vCard など)
  • 2VERSION が 2.0 か1.0 なら vCalendar。取り込める先が限られる
  • 3UTF-8 で保存されているかエディターの保存の画面で文字コードを確かめる
  • 4DTSTART の末尾の Z と TZID日本時間の数字に Z が付いていれば9時間ずれる

ICSのつまずき表と判断表

この節では、よくあるつまずきの直し方と、場面ごとにどの方法を選ぶかが一覧で分かります。

よくあるつまずき

つまずき 表示・状態 直し方
スマホで取り込めない Google アプリにファイルの取り込みが無い パソコンのブラウザで取り込み、同じアカウントで見る
購読が更新されない 元を直したのに変更前の予定のまま Outlook.com は24時間以上かかることがある。少し待つ
同じ予定が二重になる 取り込みを2回した・UID が違う 片方を消す。作る側は UID を固定する
ZIP を選んでしまう Google から書き出したファイル 展開して .ics を1つずつ取り込む
色が変わった Mac で読み込んだ 読み込みで以前のカスタムカラーは消える(Apple の記載)。付け直す
Python で読むとエラー Content line could not be parsed into parts 中身が HTML でないか、1行目を見る
Python で読むとエラー Found no components where exactly one is required END:VCALENDAR が欠けていないか見る

判断表:どの方法を選ぶか

場面 選ぶ方法 理由
会議の招待を1件受け取った メールのアプリから追加・ファイルを取り込む 変わらない1件ならコピーで困らない
祝日・行事を毎年入れたい URL で購読 配る側が更新すれば反映される
Google から Outlook へ引っ越す 書き出した .ics を取り込む 繰り返し・タイムゾーンが残る
予定を表で一覧したい ICS を CSV に変換 繰り返しは展開してから書き出す
自分のサービスで予定を配る ICS を生成し text/calendar で返す どのカレンダーでも読める
海外の人も参加する会議 TZID つきで書く 夏時間をまたいでも現地の時刻が保たれる

よくある質問

Q. ICSファイルとは何ですか? A. カレンダーの予定を、iCalendar(RFC 5545)という共通の形式で書いたテキストファイルです。拡張子は .ics、MIME タイプは text/calendar です。Google カレンダー・Outlook・Apple のカレンダーなどで読み書きできます。

Q. ICSファイルの開き方は? A. カレンダーアプリに取り込みます。Google カレンダーはパソコンの「設定」→「インポート / エクスポート」、Outlook.com は「予定表の追加」→「ファイルからアップロード」、Mac のカレンダーは「ファイル」→「読み込む」です。中身を見るだけならテキストエディターでも開けます。

Q. iPhoneでICSファイルを取り込めますか? A. Apple の iPhone ユーザガイドで確かめられたのは、.ics の URL を「照会カレンダーを追加」で登録する方法と、.ics へのリンクをタップする方法です。ファイルは、Mac で iCloud のカレンダーに読み込むか、パソコンで Google カレンダーに取り込んで、その Google アカウントを iPhone で表示します。

Q. スマホのGoogleカレンダーアプリで取り込めますか? A. Google カレンダー ヘルプでは、ICS の取り込みはパソコンで行う手順だけが案内されています。URL での購読も、パソコンのブラウザで行うと書かれています。

Q. 取り込んだ予定の時刻が9時間ずれています。 A. ファイルの DTSTART が日本時間の数字なのに、末尾に Z(UTC)が付いている可能性が高いです。Z を外して TZID=Asia/Tokyo を付けるか、UTC に直した数字で書きます。

Q. 取り込んだ予定を消すには? A. 取り込んだ予定は、ふつうの予定と同じように1件ずつ消せます。まとめて消したいときに備えて、取り込む前に専用のカレンダーを作り、そこへ取り込んでおくと、カレンダーごと消せます。

Q. ICSファイルは自分で作れますか? A. 作れます。BEGIN:VCALENDAR・VERSION:2.0・PRODID を書き、予定ごとに VEVENT の中へ UID・DTSTAMP・DTSTART を入れます。改行は CRLF、文字コードは UTF-8 にします。Python なら icalendar を使うと、エスケープや折り返しを自動で行えます。

Q. 繰り返しの予定はどう書きますか? A. VEVENT に RRULE を1行書きます。毎週火・木なら FREQ=WEEKLY;BYDAY=TU,TH、毎月末日なら FREQ=MONTHLY;BYMONTHDAY=-1 です。回数は COUNT、終わりの日時は UNTIL で決め、両方は同時に使いません。

Q. 終日の予定が1日短く表示されます。 A. DTEND に最終日を書いていないか確かめます。終日の予定の DTEND は「最終日の翌日」です。12月2日〜4日なら DTEND は 20261205 にします。

Q. ICSとvCard(.vcf)の違いは? A. ICS は予定、vCard は連絡先のファイルです。名前や電話番号が入った .vcf はカレンダーではなく連絡先のアプリで開きます。

Q. Googleカレンダーの予定をICSで書き出せますか? A. 書き出せます。Google カレンダー ヘルプによると、書き出しはパソコンでだけ行え、スマートフォンやタブレットには対応していません。書き出したファイルは、カレンダーごとの .ics が ZIP にまとまった形になるので、別のアプリに取り込むときは展開して1つずつ取り込みます。

まとめ

  • ICS は予定を書いた iCalendar(RFC 5545)のテキストで、先頭は文字の BEGIN:VCALENDAR、MIME は text/calendar、文字コードは UTF-8。
  • 取り込みは Google がパソコンの「インポート / エクスポート」、Outlook.com が「ファイルからアップロード」、Mac が「ファイル」→「読み込む」。 iPhone は URL の「照会カレンダーを追加」。
  • 取り込みはその時点のコピー、URL で購読すれば元の変更が反映される。 よく変わる予定は購読で配る。
  • 9時間のずれは、日本時間の数字に Z を付けたのが原因になりやすい。繰り返しは TZID つきで書くと夏時間をまたいでも現地の時刻が保たれる。
  • 作るときは UID を固定し、終日の DTEND は翌日、毎月末は BYMONTHDAY=-1。 CSV に変換すると繰り返しとタイムゾーンが消える。

参考・出典

いずれも2026年11月13日に確認しました。画面の名前や手順は変わることがあります。

  • RFC 5545「Internet Calendaring and Scheduling Core Object Specification (iCalendar)」:https://www.rfc-editor.org/rfc/rfc5545
  • Google カレンダー ヘルプ「Google カレンダーに予定を読み込む」:https://support.google.com/calendar/answer/37118?hl=ja
  • Google カレンダー ヘルプ「他のユーザーのカレンダーに登録する」(URL で追加):https://support.google.com/calendar/answer/37100?hl=ja
  • Microsoft サポート「Outlook.com または Outlook on the web で予定表をインポートまたは購読する」:https://support.microsoft.com/ja-JP/Outlook/import-or-subscribe-to-a-calendar-in-outlook-com-or-outlook-on-the-web
  • Microsoft サポート「Outlook への予定表のインポート」:https://support.microsoft.com/ja-jp/office/8e8364e1-400e-4c0f-a573-fe76b5a2d379
  • Apple サポート「Macでカレンダーを読み込む/書き出す」:https://support.apple.com/ja-jp/guide/calendar/icl1023/mac
  • Apple サポート「iPhoneで複数のカレンダーを設定する」:https://support.apple.com/ja-jp/guide/iphone/iph3d1110d4/ios
  • icalendar(Python のライブラリ)ドキュメント:https://icalendar.readthedocs.io/
  • python-dateutil ドキュメント(rrule):https://dateutil.readthedocs.io/

本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。

(記載例)出典:株式会社RJC「ICSファイルとは|Google・Outlook・iPhoneへの取り込み方と作り方」

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。

WE ARE HIRING

RJCで一緒に開発しながら、
成長を楽しみませんか?

RJCは、Web・モバイル・AIを活用した開発プロジェクトで、テックリードやPM・PMOも活躍するシステム開発会社です。会社を知る、待遇を確かめる、話を聞いてみる。気になるところ見てみてください!

  • 127日年間休日
  • 12時間平均残業時間
  • 毎日ガチャ遊びココロも大切にする福利厚生。アマギフなどの賞品ラインナップ!

ほかにも、チケットレストラン、書籍読み放題、2年ごとの慰労報奨(休暇 or 金一封)、11期連続の黒字決算。

ABOUT RJC RJCがどんな会社か知る 考え方、研修、働き方、福利厚生、社員の前職まで。RJCのことが丸わかり! RJC丸わかりページへ JOB DESCRIPTION 仕事内容・待遇を見てみる 仕事内容、給与・待遇、選考の流れ。経験者も未経験も!応募前に知りたいこと、まとめました! 募集要項を見る ENTRY エントリーする エントリーは1〜2分・履歴書不要です。まずは話を聞いてみたい、という方でも歓迎です! エントリーフォームへ

成長のヒミツ、 ぜんぶ丸わかり