ICSの終日予定が1日ずれるときは、「最終日だけ消える」のか、「予定全体が前日・翌日に動く」のかを分けると、確認する場所が絞れます。最終日だけ欠けるならDTEND、全体が動くなら日付の型と、書き出す前の日時変換を確認します。
この記事は、HTMLのカレンダーや計算機から.icsファイルを書き出す人向けの実装ガイドです。既存アプリの不具合を断定するものではありません。ふたりの休み合わせカレンダーの制作記や、年末年始の連休計算機の制作記に続く、日付の出力に絞った解説です。
一次資料の確認日:2026年11月14日。掲載コードの日付計算はNode.jsで確認しています。Google・Apple・Outlookの実カレンダーへの取り込みテストは未実施です。
最初に見るのはDTSTART・DTEND・VALUE=DATEの3つ
| 症状 | 最初に確認する箇所 | 見分けるポイント |
|---|---|---|
| 3日間の休みが2日間になる | DTEND | 最後の休みの日を、そのまま終了日にしていないか |
| 予定全体が前日・翌日へ動く | VALUE=DATEと生成前の日時変換 | 日付を午前0時の日時にしてから、UTCへ変換していないか |
| 開始と終了で表示がおかしい | 両方の値の型 | 開始がDATE、終了がDATE-TIMEになっていないか |
| 日付は正しいが予定が二重になる | 読み込み履歴・UID・読み込み先 | 日付の計算と、再読み込みの扱いを別々に調べる |
まず.icsをテキストエディターで開き、予定1件のBEGIN:VEVENTからEND:VEVENTを抜き出します。画面に出た日付だけでなく、ファイルに書かれた8桁の日付を見ましょう。
DTENDには「最後の日の翌日」を書く
終日予定のDTSTARTは開始日を含み、DTENDは終了日を含みません。12月1日だけ休むなら、開始は12月1日、終了の境界は12月2日です。これはiCalendarの仕様(RFC 5545・3.6.1)で定められています。
次は、2026年12月1日だけを終日予定にするファイルの例です。
BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//Next Agent//All-day example//JA
BEGIN:VEVENT
UID:example-20261201-01@example.invalid
DTSTAMP:20261114T000000Z
DTSTART;VALUE=DATE:20261201
DTEND;VALUE=DATE:20261202
SUMMARY:Day off
END:VEVENT
END:VCALENDAR
UIDとDTSTAMPは説明用の固定値です。実装では予定を識別する一意のUIDと、生成時のUTC日時を設定します。ファイルの行区切りはCRLF(\r\n)、文字コードはUTF-8で出力します。この例の固定の件名を利用者入力へ替える場合は、日付とは別にICSのテキストのエスケープも必要です。
年末の12月29日・30日・31日の3日間なら、終了は翌年1月1日になります。
DTSTART;VALUE=DATE:20261229
DTEND;VALUE=DATE:20270101
| カレンダーに表示したい休み | DTSTART | DTEND |
|---|---|---|
| 2026年12月1日の1日 | 20261201 | 20261202 |
| 2026年11月30日の1日 | 20261130 | 20261201 |
| 2026年12月29〜31日の3日 | 20261229 | 20270101 |
| 2028年2月29日の1日 | 20280229 | 20280301 |
ファイルへ書き出す前に、実際に何日休めるかを確認したい場合は、2026–2027年末年始の休みを、会社休日と有休に分けて数える手順をご覧ください。会社の休業開始が12月29日・30日・31日の場合を分けて整理しています。
Google Calendar APIでも、終了は含まない境界です。ただしAPIのstart.date・end.dateは2026-12-01のようなハイフン付きの形式で、ICSの20261201とは書式が違います。両方を扱うコードでは、書式変換も分けます。Google公式のEventsリファレンス
終日の日付に、時刻やタイムゾーンを混ぜない
「12月1日が休み」という情報には、何時何分という瞬間はありません。ICSではDTSTART;VALUE=DATE:20261201のように日付として出し、終了もDATEにそろえます。DATEにTZIDは付けません。時刻付きの会議などを表すDATE-TIMEと分けるのが基本です。RFC 5545・TZIDの規則
JavaScriptで、端末の午前0時をnew Date(2026, 11, 1)として作り、toISOString().slice(0, 10)で日付だけ切り出すと、UTCへ変換した結果を取り出すことになります。日本時間の12月1日午前0時は、UTCでは11月30日15時です。ここで前日を出力してしまう可能性があります。
反対に、new Date('2026-12-01')のような日付だけの文字列はUTCとして解釈されます。これをローカル時刻用のgetDate()などで読むと、地域によっては前日になります。文字列入力・計算・表示でUTCとローカル時刻を混ぜないでください。MDN:Dateの解釈とUTC・ローカル時刻
JavaScriptの例:日付を検証してから翌日を求める
次の例は、画面から受けたYYYY-MM-DDを年月日に分解し、UTCのメソッドだけで暦日を計算します。ここでUTCを使う目的は端末の時差を入れないことです。出力する予定を「UTCの午前0時」にする処理ではありません。
function icsDate(input, nextDay = false) {
const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(input);
if (!m) throw new Error('YYYY-MM-DDで入力してください');
const [year, month, day] = m.slice(1).map(Number);
const d = new Date(0);
d.setUTCFullYear(year, month - 1, day);
d.setUTCHours(0, 0, 0, 0);
if (d.getUTCFullYear() !== year ||
d.getUTCMonth() !== month - 1 || d.getUTCDate() !== day) {
throw new Error('存在しない日付です');
}
if (nextDay) d.setUTCDate(d.getUTCDate() + 1);
if (d.getUTCFullYear() > 9999) throw new Error('年が範囲外です');
return String(d.getUTCFullYear()).padStart(4, '0') +
String(d.getUTCMonth() + 1).padStart(2, '0') +
String(d.getUTCDate()).padStart(2, '0');
}
const start = icsDate('2026-12-29');
const end = icsDate('2026-12-31', true);
console.log(`DTSTART;VALUE=DATE:${start}`);
console.log(`DTEND;VALUE=DATE:${end}`);
// DTSTART;VALUE=DATE:20261229
// DTEND;VALUE=DATE:20270101
2026-02-30のような存在しない日付は、別の日へ丸めて出力せずエラーにします。月末・年末・うるう年も、表示用文字列に単純に「1」を足す方法では扱えません。日付が正しいことを確認してから翌日へ進めます。
2026年11月14日、上の関数をNode.js v26.3.0で実行し、通常日・月末・年末・うるう日など10例と、不正入力など8例を確認しました。実行環境のタイムゾーンをAsia/Tokyo・America/New_York・UTCに替え、3条件とも同じ期待値になりました。確認したのは日付文字列の生成で、各カレンダー製品での表示結果ではありません。
Googleカレンダーへ読み込む前後の確認手順
- 予定1件の小さなファイルにする。まず12月1日だけの予定で、DATEと翌日のDTENDを確認します。件名も短い固定文字にします。
- テスト用カレンダーを読み込み先にする。パソコン版の設定から「インポート / エクスポート」を開き、.icsと読み込み先を選びます。既定の読み込み先はメインのカレンダーなので、選択を確認します。
- 終日欄の開始日と最終日を見る。次に月末と年末をまたぐ例で、3日間がちょうど3日間になっているか確かめます。
- 修正前の予定と区別する。ファイルを直しただけで、以前読み込んだ予定が自動更新されるとは限りません。検証するファイル名・UID・読み込み先を記録します。
手順とファイル形式はGoogle公式の読み込みガイドで確認できます。ファイルの取り込みは継続的な同期ではありません。日付が正しいのに読み込めない場合は、日付の修正を増やす前に、公式の読み込みトラブルの案内からファイル形式やエラー内容を確認してください。
本記事では実カレンダーへの取り込みは行っていません。公開する生成機能では、対象にするカレンダーとブラウザーで、終日1日・月末・年末・うるう日の表示を確認してください。
AIに修正を頼むときは、期待する日付も渡す
「ICSのずれを直して」だけでは、時刻付き予定まで変換されることがあります。修正対象を終日予定に絞り、入力と出力例を一緒に渡します。次は依頼文の例です。
終日予定のICS出力だけを確認してください。入力の最終日は予定に含みます。2026-12-29〜2026-12-31を、DTSTART;VALUE=DATE:20261229、DTEND;VALUE=DATE:20270101へ変換してください。時刻付き予定の処理は変更せず、月末・年末・うるう日・存在しない日付も確認してください。
修正後は画面のカレンダーだけでなく、実際に出力したファイルの2行を比べます。期待値を手で用意しておくと、生成する処理とテストが同じ思い込みを持つ問題も見つけやすくなります。
よくある質問
1日だけの予定なのに、DTENDが翌日でよいのですか?
はい。DTENDは予定に含まない終了日です。12月1日だけなら、開始は20261201、終了は20261202です。カレンダー上で12月2日も休みになる、という意味ではありません。
終日予定にもTZID=Asia/Tokyoを付けますか?
VALUE=DATEの日付には付けません。時刻付きの予定と終日予定を分けて扱います。DTSTAMPのような作成時刻の項目は別で、終日予定でもUTCの日時を書きます。
DTENDを省略してもよいのですか?
RFC 5545では、DTSTARTがDATEで、DTENDもDURATIONもない予定は1日として扱います。複数日の休みを出す処理では、最終日の翌日をDTENDに明示すると確認しやすくなります。
ファイルを直したら、読み込み済みの予定も自動で直りますか?
ファイルの読み込みは継続的な同期ではありません。修正前の予定と修正後の予定を見分け、テスト用カレンダーで再確認してください。同じファイルを重ねて読み込む動作を、自動更新と決めつけないことが大切です。
カレンダーを作る工程も確認する
日付の数え方と、カレンダーへ書き出す形式は別々に確認すると原因を絞れます。アプリ全体の設計については、年末年始の連休計算機の制作記を、画面の印刷で余分なページが出る場合はHTMLカレンダーで白紙の2ページ目が出る場合の確認方法をご覧ください。


コメント