Googleスプレッドシートで祝日一覧を自動更新する方法と2025年の祝日がうまく抽出できない問題の解決策

Google Apps Script（GAS）を使用して、Googleスプレッドシートに祝日一覧を自動更新することは非常に便利ですが、2025年の祝日がうまく抽出できないという問題が発生している場合があります。この記事では、その問題を解決する方法を詳しく解説します。

1. Google Apps Scriptで祝日を自動更新する基本の流れ
2. 2025年の祝日が抽出できない原因
3. 解決策：日付範囲を確認する
4. Googleカレンダーの祝日データを確認する
5. スクリプトの改良：自動化をさらに効率的に
6. まとめ：祝日一覧の自動更新と2025年の祝日抽出問題の解決

1. Google Apps Scriptで祝日を自動更新する基本の流れ

Google Apps Script（GAS）を使用して、祝日一覧を自動的に更新するためには、まずGoogleカレンダーから祝日データを取得する必要があります。日本の祝日データは、Googleの「日本の祝日カレンダー」を利用することが一般的です。このカレンダーを使用して、祝日の日付とタイトルを取得し、それをGoogleスプレッドシートに自動的に追記します。

基本的には、`CalendarApp.getCalendarById()`関数を使って、日本の祝日カレンダーからイベントを取得し、祝日一覧に必要な情報を抽出します。この情報をスプレッドシートの指定のセルに記入するために、`setValues()`を使ってデータを入力します。

2. 2025年の祝日が抽出できない原因

質問者の方が述べているように、2025年の祝日がうまく抽出できないという問題にはいくつかの原因が考えられます。最も一般的な原因は、スクリプト内で設定されている日付範囲が正しくないことです。

スクリプト内では、以下のように祝日を取得する期間を設定しています。

const startTime = new Date(today);
startTime.setMonth(0);  // 1月に設定
startTime.setDate(1);  // 1日に設定
const thisYear = startTime.getFullYear();
const endTime = new Date(startTime);
endTime.setFullYear(thisYear + 1);  // 1年後に設定

このコードは「今年の1月1日」から「翌年の1月1日」までの期間を指定していますが、2025年の祝日が抽出できない原因としては、スクリプトが実行されるタイミングがずれている可能性や、指定された日付範囲が不完全な場合が考えられます。

3. 解決策：日付範囲を確認する

2025年の祝日が取得できない場合、まず最初に確認すべきなのは、`startTime`と`endTime`の日付範囲が正しく設定されているかどうかです。特に、祝日データを取得する期間が「2025年を含んでいるか」を確認しましょう。

もしスクリプトが実行されているタイミングが2025年をまだ迎えていない場合、`startTime`や`endTime`の設定を動的に調整する必要があります。例えば、次のようにして2025年を含む期間を確保できます。

const today = new Date();
today.setHours(0, 0, 0, 0);
const thisYear = today.getFullYear();
const startTime = new Date(thisYear, 0, 1);  // 1月1日
const endTime = new Date(thisYear + 1, 0, 1);  // 翌年の1月1日

このコードは、常に「今年の1月1日」から「翌年の1月1日」までの期間を設定します。この方法で、毎年祝日データを正しく取得できるようになります。

4. Googleカレンダーの祝日データを確認する

さらに、祝日データがカレンダーに正しく反映されているかも確認が必要です。Googleカレンダーの日本の祝日カレンダー（`ja.japanese#holiday@group.v.calendar.google.com`）が正しくデータを提供していない場合、祝日が取得できないことがあります。

Googleカレンダーで「日本の祝日カレンダー」を確認し、必要な祝日がカレンダーに追加されているかどうかをチェックしてください。もしカレンダー自体に祝日データが不足している場合は、手動で祝日を追加することができます。

5. スクリプトの改良：自動化をさらに効率的に

スクリプトを毎年自動実行するには、Google Apps Scriptの時間主導トリガーを活用することが重要です。毎年自動で祝日データを更新したい場合、`ScriptApp.newTrigger()`を使用して、毎年1月1日に自動で実行されるように設定することができます。

以下のコードを使うことで、毎年1月1日に自動的に祝日を更新できます。

function createTimeDrivenTriggers() {
  ScriptApp.newTrigger('getHolidays')
      .timeBased()
      .onMonthDay(1)  // 毎月1日に実行
      .atHour(0)      // 早朝に実行
      .create();
}

これにより、手動で実行することなく、毎年自動で祝日データを更新することができます。