コンテンツにスキップ
祝日の取り込み

祝日の取り込み

「祝日の取り込み」では、祝日のデータを一度に取り込むことができます。決められた形式(フォーマット)のファイルからと、日本(日本語)とアメリカ合衆国(英語)に関してはインターネットから取り込むことが可能です。

祝日の取り込み

設定ウインドウの左側で「祝日の取り込み」を選択します。

図1: 祝日の取り込み

取り込み先となる 「国/地域」 と 「言語」 を選択します。これはファイルから取り込む場合であってもインターネットから取り込む場合であっても共通です。

重要

ここで選択した国/地域と言語へデータが取り込まれます。データ内の言語は判別しません。
つまり、「日本」と「日本語」を選択したとき、データが英語であれば英語のまま取り込まれます。

ファイルから取り込む

「ファイルから」を選択します。(既定では「ファイルから」になっています。「インターネットから」を選択していた場合、切り替わるとファイルのパスを入力する欄が表示されます。) ファイルのパスを入力するか、 ボタンを押してファイルを選択します。
次に、「差分」または「上書き」を選択し、取り込み ボタンを押すと取り込むことができます。

「差分」と「上書き」

  • 差分
    既に祝日として設定されている日付と取り込むデータの日付が一致していた場合、既に設定されている祝日が優先され、そのデータは取り込まれません。
  • 上書き
    既に祝日として設定されている日付と取り込むデータの日付が一致していた場合、取り込むデータが優先されます。日付は同じなので、名称が更新されます。

ファイル形式

取り込み可能なファイル形式は CSV または iCalendar の2種類です。

CSV形式

Comma-Separated Values(カンマ区切り値)のことです。
文字のエンコードはUTF-8で、改行はCR+LF(キャリッジリターンおよびラインフィード)です。 一行毎に入れることができるのは、「日付」と「祝日名(名称)」です。日付と祝日名はカンマで区切ります。
行の最初に現れるカンマが区切り文字として認識されます。それ以降のカンマは祝日名の一部として扱われます。
日付形式は ISO 8601 です。 付は、4桁の年、2桁の月、2桁の日をハイフン(-)で区切ります。

形式:  
<YYYY-MM-DD>,<祝日名><CR+LF>

例)2025年1月1日、祝日名「元日」

2025-01-01,元日⏎
記号 ⏎ は改行 (CR+LF) を表しています。

下記は、複数のデータを指定する例です。

2025-01-01,元日⏎
2025-04-29,昭和の日,設立記念日⏎
2025-05-05,こどもの日⏎
2025-11-03,文化の日⏎

注意

2行目の祝日名には、カンマ(,)が含まれていますが、区切り文字としては扱われません。

テキストエディタなどでデータを作成し、.csv の拡張子が付いたファイル名として保存すると使用することができます。

iCalendar形式

Internet Calendaring and Scheduling Core Object Specification(インターネットカレンダーおよびスケジューリングコアオブジェクト仕様) のことです。
iCalendarは RFC 5545 に規定されています。
文字のエンコードはUTF-8、改行コードはCR+LF(キャリッジリターンとラインフィード)です。以下CR+LFは⏎で表されます。

祝日には「VEVENT」コンポーネントが使用されます。
「DTSTART」プロパティに日付を定義し、「SUMMARY」プロパティに祝日名を定義します。
日付は区切り文字なしで、4桁の年、2桁の月、2桁の日を指定します。日付は、「DTSTART」プロパティ内に「VALUE」と「DATE」プロパティを使用して定義します。

日付の形式
DTSTART;VALUE=DATE:YYYYMMDD⏎
祝日名
SUMMARY:祝日名⏎

各日付と名称は「VEVENT」コンポーネント内に入れます。(BEGIN:VEVENTとEND:VEVENTの間)

VEVENTコンポーネント
BEGIN:VEVENT⏎
DTSTART;VALUE=DATE:20250101⏎
SUMMARY:元日⏎
END:VEVENT⏎

iCalendar形式は、全体をiCalendarオブジェクト内に入れます。(BEGIN:VCALENDARとEND:VCALENDARの間)

iCalendarオブジェクト
BEGIN:VCALENDAR⏎
BEGIN:VEVENT⏎
DTSTART;VALUE=DATE:20250101⏎
SUMMARY:元日⏎
END:VEVENT⏎
END:VCALENDAR⏎

下記は、複数のデータを指定する例です。複数の「VEVENT」コンポーネントを「iCalendar」オブジェクト内に入れます。

複数のデータ指定例
BEGIN:VCALENDAR⏎
BEGIN:VEVENT⏎
DTSTART;VALUE=DATE:20250101⏎
SUMMARY:元日⏎
END:VEVENT⏎
BEGIN:VEVENT⏎
DTSTART;VALUE=DATE:20250429⏎
SUMMARY:昭和の日\, 設立記念日⏎
END:VEVENT⏎
BEGIN:VEVENT⏎
DTSTART;VALUE=DATE:20250505⏎
SUMMARY:こどもの日⏎
END:VEVENT⏎
BEGIN:VEVENT⏎
DTSTART;VALUE=DATE:20251103⏎
SUMMARY:文化の日⏎
END:VEVENT⏎
BEGIN:VEVENT⏎
DTSTART;VALUE=DATE:20251123⏎
SUMMARY:勤労感謝の日⏎
END:VEVENT⏎
END:VCALENDAR⏎

重要

上記データの2番目の「VEVENT」コンポーネント内の「SUMMARY」にはカンマ(,)が含まれています。iCalendarの仕様に従って、カンマはバックスラッシュ(\)でエスケープしなければなりません。

テキストエディタなどでデータを作成し、.ics の拡張子が付いたファイル名で保存することで使用可能になります。

インターネットから取り込む

PCがインターネットにアクセス可能な場合、インターネットを介して休日のデータを取り込むことができます。

取り込み可能なデータ

国/地域言語データ元
日本日本語内閣府 国民の祝日
アメリカ合衆国英語連邦祝日(Federal Holidays)

注意

データ取得元のフォーマット変更等により取り込みに失敗する可能性があります。

取り込み方法

図1のウインドウで操作します。

「国/地域」と「言語」の選択

取り込み先の「国/地域」と「言語」を選びます。

ラジオボタン

「インターネット」のラジオボタンを選択します。

オプションの選択

「差分」または「上書き」のいずれかを選択します。

実行

取り込み ボタンを押します。

「差分」と「上書き」

  • 差分
    既に祝日として設定されている日付と取り込むデータの日付が一致していた場合、既に設定されている祝日が優先され、そのデータは取り込まれません。
  • 上書き
    既に祝日として設定されている日付と取り込むデータの日付が一致していた場合、取り込むデータが優先されます。日付は同じなので、名称が更新されます。