結論
ICSファイル(.ics)は、予定の日時・件名・場所・繰り返しを書いた、iCalendar(RFC 5545)という共通の形式のテキストファイルです。Googleカレンダーならパソコンの「設定」→「インポート / エクスポート」、Outlook.comなら「予定表の追加」→「ファイルからアップロード」、Macのカレンダーなら「ファイル」→「読み込む」で取り込めます。
この記事でわかること
- Google・Outlook・iPhone・Mac・Androidへの取り込み方と、URLで購読する方法との違い
- PythonでICSを作って読み戻した実物(先頭のバイト・折り返し・繰り返しの展開)
- 時刻が9時間ずれる・文字化けする原因を、3通りの時刻の書き方で再現した結果
この記事で実際に動かしたもの: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 のファイルはパソコンで取り込める、と書かれています。
パソコンで Google カレンダーを開く
ブラウザで Google カレンダーを開き、右上の設定のアイコンから「設定」を選びます。
「インポート / エクスポート」を開く
左側のメニューで「インポート / エクスポート」を選びます。
ファイルを選ぶ
「パソコンからファイルを選択」で .ics ファイルを選びます。
追加先のカレンダーを選んで「インポート」
取り込み先のカレンダーを選びます(既定はメインのカレンダー)。仕事用と個人用を分けているなら、ここで選び直します。
- 予定のゲストと会議のデータは取り込まれません(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 へのリンクをタップする方法です。
- カレンダーアプリで、カレンダーのボタンをタップし「カレンダーを追加」をタップします。
- 「照会カレンダーを追加」をタップします。
- 照会したい .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件・研修の日程・控え | 祝日・行事・時間割・チームの予定表 |
よく変わる予定表を配るとき
見分ける問い:「この予定は配ったあとに変わるか」
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時刻が決まっている → TZID つきで書く会議・面談・リリース作業など
- 2世界中で同じ瞬間 → UTC(Z)でもよい配信の開始・メンテナンスの開始など繰り返さないもの
- 3日付だけ → VALUE=DATE祝日・締め切り日・研修の日程。DTEND は翌日
- 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期連続の黒字決算。