このプラグインでできること
「日付計算プラグイン」は、基準となる日付フィールドの値から、別の日付フィールドへ日付を自動で計算・入力するプラグインです。
「当月末」「翌月20日」「30日後」といった計算をルールとして登録できます。
計算結果が土日・祝日・会社休日に当たった場合は、前後の営業日へ自動でずらせます。
サブテーブル(テーブル)内の日付フィールドにも対応しています。
主な機能は次のとおりです。
- 基準日フィールドの値が変わったタイミングで、対象の日付フィールドを自動計算・自動入力
- 「基準日の当月」「基準日からの日数」「基準日からの月数」の3種類の計算方法
- 存在しない日付(例:2月31日)を指定した場合、その月の月末日へ自動調整
- 計算結果が休日のとき「翌営業日」または「前営業日」へ自動調整
- 土曜日・日曜日・祝日を休日扱いにするかどうかの切り替え
- 会社独自の休業日(会社休日)と、土日祝でも出勤する日(会社営業日)の登録
- 対象の日付フィールドを編集不可にする設定
- ルールの複数登録・並び替え・有効/無効の切り替え
- 設定画面上での計算結果のリアルタイムプレビュー
- 設定内容のJSONファイル出力・読込
動作環境・前提条件
2-1. 対応画面
| 画面 | 対応 |
|---|---|
| PCのレコード追加画面 | 対応 |
| PCのレコード編集画面 | 対応 |
| PCの一覧画面(インライン編集) | 対応 |
| モバイルのレコード追加画面 | 対応 |
| モバイルのレコード編集画面 | 対応 |
| レコード詳細画面(閲覧のみ) | 該当なし |
2-2. 事前に必要なフィールド
設定を行う前に、アプリに次のフィールドを用意してください。
| 用途 | 必要なフィールドの種類 |
|---|---|
| 基準フィールド(計算のもとになる日付) | 「日付」フィールド または 「日時」フィールド |
| 対象フィールド(計算結果を入れる日付) | 「日付」フィールドのみ |
⚠️ 対象フィールドに「日時」フィールドは指定できません。対象は「日付」フィールドのみです。
💡 サブテーブル内の日付フィールドも使用できます。ただし、基準フィールドと対象フィールドは同じテーブル内である必要があります。メインのフィールドとサブテーブル内のフィールドを組み合わせることはできません。
2-3. 内蔵している祝日データ
祝日の判定には、プラグインに内蔵された日本の祝日データを使用します。
対象期間は2025年から2030年までです(国民の祝日・振替休日・国民の休日を含みます)。
2-4. 必要な権限
| 対象者 | 必要な権限 |
|---|---|
| 設定する方 | 対象アプリの「アプリ管理権限」 |
| 利用する方 | 対象アプリのレコードを追加・編集できる権限 |
💡 「設定保存」を押すと、アプリの更新(「アプリを更新」)まで自動で行われます。そのため、設定する方にはアプリ管理権限が必要です。
⚠️ 一覧画面のインライン編集でも、基準フィールドを変えると対象フィールドが再計算されます。ただし、「対象フィールドを編集不可にする」はインライン編集の開始時には適用されません。インライン編集では、対象フィールドを手で書き換えられる場合があります。
設定手順
3-1. 設定画面の全体構成
設定画面は、次の手順で開きます。
- 対象のアプリを開き、画面右上の歯車アイコンから「アプリの設定」を開きます。
- 「設定」タブの「プラグイン」を選びます。
- 一覧から「日付計算プラグイン」の歯車アイコンをクリックします。
設定画面は、上部のヘッダーと2つのタブで構成されています。
設定画面のヘッダー
ヘッダーには次のボタンがあります。
| ボタン | 説明 |
|---|---|
| 「設定保存」 | 設定内容を保存し、アプリへ反映します |
| ×(バツ印のアイコン) | 保存せずに前の画面へ戻ります |
| 「設定出力」 | 現在の設定をJSONファイルとしてダウンロードします |
| 「設定読込」 | JSONファイルから設定を読み込みます |
タブは次の2つです。
| タブ | 説明 |
|---|---|
| 「日付設定」 | 日付を計算するルールを登録します |
| 「休日設定」 | どの日を休日扱いにするかを設定します |
「日付設定」「休日設定」タブ
💡 選択中のタブは記憶されます。画面を再読み込みしても、直前に開いていたタブが表示されます。
3-2. 「日付設定」タブでルールを追加する
日付を自動計算するルールを1件ずつ登録します。
- 設定画面の上部で、「日付設定」タブをクリックします。
- 画面下部の「+ ルールを追加」ボタンをクリックします。
- ルールのカードが1枚追加されます。
「+ ルールを追加」ボタン
💡 ルールが1件も登録されていないときは、「ルールが登録されていません。下の「ルールを追加」ボタンから作成してください。」と表示されます。
- 追加されたカードの入力欄に、ルール名を入力します。
- 入力欄には「ルール名(例:支払期日の自動設定)」と表示されています。
- ルール名は設定画面での識別用です。レコード画面には表示されません。
ルール名を入力する
- カードの「基準フィールド」で、計算のもとにする日付フィールドを選択します。
- 「日付」フィールドと「日時」フィールドが選択肢に表示されます。
- フィールド名のうしろに、かっこ書きで「(日付)」または「(日時)」と種類が表示されます。
- サブテーブル内のフィールドは、先頭に
[テーブル名]が付いて表示されます。
「基準フィールド」を選ぶ
💡 「日時」フィールドを基準にした場合、時刻は使用されません。日付部分のみを使って計算します。
3-3. 計算方法を設定する
「計算方法」では、次の3種類から選択します。
| 選択肢 | 説明 |
|---|---|
| 「基準日の当月」 | 基準日と同じ月の中で日付を決めます |
| 「基準日からの日数」 | 基準日から何日前/何日後かで日付を決めます |
| 「基準日からの月数」 | 基準日から何ヶ月前/何ヶ月後かの月の中で日付を決めます |
- カードの「計算方法」で、使用する計算方法を選択します。
- 選択した内容に応じて、右側の「指定」欄の入力項目が切り替わります。
「計算方法」を選ぶ
3-3-1. 「基準日の当月」を選んだ場合
- 「指定」欄のプルダウンで、「月初(1日)」「月末」「指定日」のいずれかを選択します。
| 選択肢 | 計算結果 |
|---|---|
| 「月初(1日)」 | 基準日と同じ月の1日 |
| 「月末」 | 基準日と同じ月の最終日 |
| 「指定日」 | 基準日と同じ月の、指定した日 |
- 「指定日」を選んだ場合は、右側の数値入力欄に日を入力します。
- 入力できる範囲は1から31です。
- 入力欄のうしろには「日」と表示されます。
「基準日の当月」の指定
3-3-2. 「基準日からの日数」を選んだ場合
- 「指定」欄の数値入力欄に、日数を入力します。
- 0以上の数値を入力してください。
- 数値入力欄の右側のプルダウンで、「前」または「後」を選択します。
| 選択肢 | 計算結果 |
|---|---|
| 「前」 | 基準日から、指定した日数だけさかのぼった日 |
| 「後」 | 基準日から、指定した日数だけ進んだ日 |
「基準日からの日数」の指定
3-3-3. 「基準日からの月数」を選んだ場合
- 「指定」欄の数値入力欄に、月数を入力します。
- 0以上の数値を入力してください。
- 入力欄のうしろには「ヶ月」と表示されます。
- 「前」または「後」を選択します。
- 「の」の右側のプルダウンで、「月初(1日)」「月末」「指定日」のいずれかを選択します。
- 「指定日」を選んだ場合は、右側の数値入力欄に日を入力します。
- 入力できる範囲は1から31です。
「基準日からの月数」の指定
💡 「1ヶ月」「後」「月末」と設定すると、翌月の最終日が計算されます。「2ヶ月」「後」「指定日」に「20」と設定すると、2ヶ月後の20日が計算されます。
💡 指定した日がその月に存在しない場合は、その月の最終日に自動調整されます。例えば「1ヶ月後の31日」と設定し、基準日が1月15日の場合、計算結果は2月28日(うるう年は2月29日)になります。
3-4. 対象フィールドと編集制御を設定する
- カードの「対象フィールド」で、計算結果を入力する日付フィールドを選択します。
- 選択肢には「日付」フィールドのみが表示されます。
- 表示されるのは、基準フィールドと同じテーブル内のフィールドだけです。
「対象フィールド」を選ぶ
⚠️ 「基準フィールド」を変更すると、テーブルが異なる場合は「対象フィールド」の選択が自動的にクリアされます。基準フィールドを変更したあとは、対象フィールドを選び直してください。
- 対象フィールドを手入力させたくない場合は、「編集制御」の「対象フィールドを編集不可にする」にチェックを入れます。
- チェックを入れると、レコードの追加・編集画面で対象フィールドが入力できない状態になります。
「対象フィールドを編集不可にする」
3-5. 営業日調整を設定する
計算結果が休日に当たったとき、前後の営業日へずらす設定です。
- カード内の「計算結果が休日(土日・祝日・会社休日)の場合は営業日に調整する」にチェックを入れます。
- チェックを入れると、下に「翌営業日」「前営業日」の選択肢が表示されます。
- 「翌営業日」または「前営業日」のいずれかを選択します。
| 選択肢 | 動作 |
|---|---|
| 「翌営業日」 | 休日に当たった場合、あとの日付方向で最初の営業日にずらします |
| 「前営業日」 | 休日に当たった場合、前の日付方向で最初の営業日にずらします |
営業日調整の設定
💡 連続した休日(ゴールデンウィークや年末年始など)の場合も、営業日に到達するまでずらし続けます。
⚠️ どの日を休日扱いにするかは、「休日設定」タブの内容に従います。営業日調整を使う場合は、「休日設定」タブも確認してください。
3-6. プレビューで計算結果を確認する
各ルールのカード下部には、計算結果のプレビューが表示されます。
- 表示形式:「基準日が (今日の日付) のとき → (計算結果)」
- 今日の日付を基準にした場合の結果が表示されます。
- 営業日調整・会社休日・会社営業日の設定もすべて反映されます。
計算結果のプレビュー
💡 設定を変更するとプレビューはその場で更新されます。保存前に、意図した日付になるか確認してください。
3-7. ルールの並び替え・無効化・削除
3-7-1. ルールを並び替える
- 並び替えたいルールカードの左端にあるドラッグハンドル(点が並んだアイコン)にマウスカーソルを合わせます。
- そのままドラッグして、移動したい位置でドロップします。
- カードの順番が入れ替わり、右側の番号(#1、#2 など)も振り直されます。
ドラッグハンドルでルールを並び替える
3-7-2. ルールを一時的に無効にする
- ルールカード上部のトグルスイッチをクリックして、オフにします。
- カードに「この設定は無効中です」と表示されます。
- 無効にしたルールは、レコード画面での自動計算に使われません。
無効にしたルールのカード
3-7-3. ルールを削除する
- ルールカード右端のゴミ箱アイコンをクリックします。
- 「削除確認」のダイアログが表示されます。
- 内容を確認し、「削除」ボタンをクリックします。
- 削除を取りやめる場合は「キャンセル」をクリックします。
「削除確認」のダイアログ
3-8. 「休日設定」タブで休日を設定する
「休日設定」タブでは、営業日調整を有効にしたルールで、どの日を「休日扱い」にするかを設定します。
- 設定画面の上部で、「休日設定」タブをクリックします。
「休日設定」タブ
⚠️ 「休日設定」タブの内容は、アプリ内のすべてのルールに共通で適用されます。ルールごとに別々の休日を設定することはできません。
3-8-1. 休日扱いにする曜日・祝日を設定する
「休日扱いにする曜日・祝日」の欄で、次の3つのチェックボックスを設定します。
| 項目 | 説明 | 初期値 |
|---|---|---|
| 「土曜日を休日扱いにする」 | 土曜日を休日として判定します | チェックあり |
| 「日曜日を休日扱いにする」 | 日曜日を休日として判定します | チェックあり |
| 「祝日(国民の祝日・振替休日・国民の休日)を休日扱いにする」 | 内蔵の祝日データに該当する日を休日として判定します | チェックあり |
- 休日扱いにしない曜日がある場合は、該当するチェックボックスのチェックを外します。
休日扱いにする曜日・祝日のチェックボックス
💡 土曜出勤の会社では「土曜日を休日扱いにする」のチェックを外します。祝日も営業する場合は「祝日(国民の祝日・振替休日・国民の休日)を休日扱いにする」のチェックを外します。
3-8-2. 会社休日を登録する
年末年始やお盆など、会社独自の休業日を1日ずつ登録します。
「会社休日」の欄には「上記の曜日・祝日に加えてここで指定した日も休日扱いになります」と説明が表示されています。
- 「会社休日」の欄にある日付の入力欄をクリックします。
- カレンダーが表示されます。
- カレンダーから登録したい日付を選択します。
- 「+ 追加」ボタンをクリックします。
- 下のリストに日付が追加されます。
会社休日の日付を選んで追加する
- 登録する日付の数だけ、手順1から3を繰り返します。
登録した会社休日のリスト
💡 1件も登録されていないときは「会社休日は登録されていません」と表示されます。
登録した日付を削除する手順は次のとおりです。
- 削除したい日付の右側にある×印をクリックします。
- リストから日付が削除されます。
⚠️ 日付を選択せずに「+ 追加」を押すと、「日付を選択してください」と表示されます。
⚠️ すでに登録済みの日付を追加しようとすると、「既に登録されています」と表示されます。
⚠️ 「会社営業日」に登録済みの日付を追加しようとすると、「会社営業日に登録されているため、休日として登録できません」と表示されます。
3-8-3. 会社営業日を登録する
土日や祝日でも出勤する日を登録します。
「会社営業日」の欄には「土日や祝日でも出勤する日を指定すると、その日は営業日として扱われます(最優先)」と説明が表示されています。
- 「会社営業日」の欄にある日付の入力欄をクリックします。
- カレンダーが表示されます。
- カレンダーから登録したい日付を選択します。
- 「+ 追加」ボタンをクリックします。
- 下のリストに日付が追加されます。
会社営業日の日付を選んで追加する
- 登録する日付の数だけ、手順1から3を繰り返します。
💡 1件も登録されていないときは「会社営業日は登録されていません」と表示されます。
登録した日付を削除する手順は次のとおりです。
- 削除したい日付の右側にある×印をクリックします。
- リストから日付が削除されます。
⚠️ 「会社休日」に登録済みの日付を追加しようとすると、「会社休日に登録されているため、営業日として登録できません」と表示されます。同じ日付を「会社休日」と「会社営業日」の両方に登録することはできません。
3-8-4. 休日判定の優先順位
日付が休日かどうかは、次の順番で判定されます。上にあるものほど優先されます。
| 優先順位 | 判定要素 | 結果 |
|---|---|---|
| 1 | 「会社営業日」に登録されている | 営業日として扱います |
| 2 | 「会社休日」に登録されている | 休日として扱います |
| 3 | 「土曜日を休日扱いにする」「日曜日を休日扱いにする」の設定に該当する | 休日として扱います |
| 4 | 「祝日(国民の祝日・振替休日・国民の休日)を休日扱いにする」がチェックあり、かつ祝日データに該当する | 休日として扱います |
💡 例えば、祝日である日を「会社営業日」に登録すると、その日は営業日として扱われます。
3-9. 設定を保存する
- 設定画面の左上にある「設定保存」ボタンをクリックします。
- 入力内容に問題がなければ保存が実行され、アプリの更新まで自動で行います。
- 「設定を保存して、アプリを更新しました」と表示されたら完了です(「アプリを開く」でアプリの一覧画面へ、「設定を続ける」で設定画面に残ります)。
「設定保存」ボタン
💡 キーボードの Ctrl キーを押しながら S キーを押しても保存できます(Mac の場合は Command キー+Sキー)。
💡 保存すると、アプリの更新(「アプリを更新」)まで自動で実行されます。「アプリの設定」画面で改めて「アプリを更新」を押す必要はありません。ほかに更新していない変更がある場合は、それらも同時に反映されます。
⚠️ 「設定は保存しましたが、アプリを更新できませんでした」と表示された場合は、設定は保存されていますが、アプリの更新が済んでいません。「アプリの設定に戻る」を押し、「アプリの設定」画面で「アプリを更新」をクリックしてください。
3-9-1. 保存できないときのメッセージ
入力に不備がある場合は、「入力エラー」というダイアログが表示され、保存されません。表示される主なメッセージは次のとおりです。
| メッセージ | 対処方法 |
|---|---|
| 「基準フィールドを選択してください」 | 該当ルールの「基準フィールド」を選択します |
| 「対象フィールドを選択してください」 | 該当ルールの「対象フィールド」を選択します |
| 「基準と対象は同じテーブル内のフィールドを指定してください」 | 基準フィールドと対象フィールドを、同じテーブル内のフィールドに揃えます |
| 「基準と対象に同じフィールドは指定できません」 | 基準フィールドと対象フィールドに、別々のフィールドを指定します |
| 「指定日は1〜31の範囲で入力してください」 | 「指定日」の数値を1から31の範囲で入力します |
| 「日数は0以上で入力してください」 | 「基準日からの日数」の数値を0以上で入力します |
| 「月数は0以上で入力してください」 | 「基準日からの月数」の数値を0以上で入力します |
| 「対象フィールド「(フィールド名)」が複数のルールで重複しています。1つの対象に対しルールは1つにしてください」 | 同じ対象フィールドを使っている有効なルールが複数あります。どちらかを無効にするか、対象フィールドを変更します |
💡 メッセージの先頭には「ルール#1(ルール名)」のように、対象のルールが表示されます。該当のカードを確認してください。
3-10. 設定を出力・読込する
設定内容をJSONファイルとして保存したり、別のアプリへ引き継いだりできます。
3-10-1. 設定を出力する
- 設定画面の右上にある「設定出力」をクリックします。
- 設定内容がJSONファイルとしてダウンロードされます。
- ファイル名は
date-config-(アプリID).jsonです。
設定画面右上の「設定出力」「設定読込」
3-10-2. 設定を読み込む
- 設定画面の右上にある「設定読込」をクリックします。
- ファイル選択の画面が開きます。
- 読み込むJSONファイルを選択します。
- 「設定を読み込みますか?」というダイアログが表示されます。
- ダイアログには「現在の設定はすべて上書きされます。読み込み後、「設定保存」を押すと確定されます。」と表示されます。
- 「読み込む」ボタンをクリックします。
- 読み込みが完了すると「設定を読み込みました」と表示されます。
「設定を読み込みますか?」のダイアログ
- 読み込まれた内容を確認します。
- 「設定保存」ボタンをクリックして確定します。
⚠️ 「設定読込」だけでは設定は確定しません。必ず「設定保存」を押してください。
⚠️ 読み込んだ設定に、現在のアプリに存在しないフィールドが含まれていた場合、そのフィールドの指定は空になります。ダイアログに「※ 現在のアプリに存在しないため取り込めなかったフィールドがあります:」と、該当するルールとフィールドが表示されます。読み込み後に、該当ルールのフィールドを選び直してください。
⚠️ 他のプラグインでダウンロードしたファイルや、形式が異なるファイルを選択すると、「設定ファイルの形式が正しくありません」と表示されます。「日付計算プラグインでダウンロードした設定ファイルを選択してください。」というメッセージが表示された場合は、ファイルを確認してください。
3-11. 設定項目の一覧
「日付設定」タブ(ルールごと)
| 項目 | 内容 | 初期値 | 必須 |
|---|---|---|---|
| 有効/無効(トグルスイッチ) | ルールを自動計算に使うか | 有効 | ― |
| ルール名 | 設定画面での識別用の名前 | 空欄 | 任意 |
| 基準フィールド | 計算のもとにする日付・日時フィールド | なし | 必須 |
| 計算方法 | 「基準日の当月」「基準日からの日数」「基準日からの月数」 | 基準日の当月 | 必須 |
| 指定 | 月初・月末・指定日(1〜31)、日数・月数(0以上)、前/後 | 月初(1日)。日数は0日後、月数は1ヶ月後の月初 | 必須 |
| 対象フィールド | 計算結果を入れる日付フィールド(基準と同じテーブル内) | なし | 必須 |
| 対象フィールドを編集不可にする | 対象フィールドを手入力できなくする | チェックなし | 任意 |
| 計算結果が休日の場合は営業日に調整する | 休日なら翌営業日・前営業日へずらす | チェックなし(チェックを入れたときは「翌営業日」) | 任意 |
「休日設定」タブ(全ルール共通)
| 項目 | 内容 | 初期値 |
|---|---|---|
| 土曜日を休日扱いにする | 土曜日を休日として判定する | チェックあり |
| 日曜日を休日扱いにする | 日曜日を休日として判定する | チェックあり |
| 祝日(国民の祝日・振替休日・国民の休日)を休日扱いにする | 内蔵の祝日データ(2025〜2030年)で判定する | チェックあり |
| 会社休日 | 追加で休日扱いにする日 | なし |
| 会社営業日 | 土日祝でも営業日扱いにする日(最優先) | なし |
使い方
4-1. レコードの追加画面で日付を自動入力する(PC)
ここでは、設定済みのルールが「基準フィールド:受注日/計算方法:基準日からの月数/1ヶ月後の月末/対象フィールド:支払期日」の場合を例に説明します。
- アプリの一覧画面で、レコードの追加画面を開きます。
- 基準フィールド(例:受注日)に日付を入力します。
- 入力した瞬間に、対象フィールド(例:支払期日)へ計算結果が自動で入力されます。
基準フィールドに入力すると対象フィールドに日付が入る
- 内容を確認し、レコードを保存します。
💡 対象フィールドの値は、ルールで「対象フィールドを編集不可にする」を設定していなければ、手入力で上書きできます。
4-2. 基準日を変更したときの動き
- レコードの編集画面を開きます。
- 基準フィールドの日付を別の日付に変更します。
- 対象フィールドの値が、新しい基準日をもとに再計算されます。
- 対象フィールドに手入力した値があった場合も、再計算した値で上書きされます。
基準日を変更すると対象フィールドが再計算される
⚠️ 対象フィールドを手入力で修正したあとに基準日を変更すると、手入力した値は再計算結果で上書きされます。
4-3. 基準日を空にしたときの動き
- レコードの編集画面で、基準フィールドの日付を削除して空にします。
- 対象フィールドの値も自動的に空になります。
基準日を空にすると対象フィールドも空になる
4-4. サブテーブル内の日付を自動入力する
サブテーブル内の日付フィールドを基準・対象に設定している場合の使い方です。
- レコードの追加画面または編集画面を開きます。
- サブテーブルの行にある基準フィールドへ日付を入力します。
- 入力した行の対象フィールドにだけ、計算結果が入力されます。
- 他の行の日付は変更されません。
サブテーブルの行に日付が入る
- 行を追加する場合は、サブテーブルの行追加ボタンをクリックします。
- 追加した行の基準フィールドへ日付を入力します。
- その行の対象フィールドに計算結果が入力されます。
追加した行にも日付が入る
💡 「対象フィールドを編集不可にする」を設定している場合、追加した行の対象フィールドにも編集不可の状態が適用されます。
4-5. 一覧画面のインライン編集で使う
- アプリの一覧画面を表示します。
- 編集したいレコードの行にある編集アイコンをクリックし、インライン編集の状態にします。
- 基準フィールドの日付を変更します。
- 対象フィールドの値が再計算されます。
- 保存アイコンをクリックしてレコードを保存します。
4-6. モバイル版で使う
- モバイル版kintoneでアプリを開きます。
- レコードの追加画面または編集画面を開きます。
- 基準フィールドに日付を入力します。
- 対象フィールドに計算結果が自動で入力されます。
モバイルの追加画面で日付が入る
💡 PCと同じルールがそのまま適用されます。モバイル専用の設定はありません。
4-7. 設定内容の組み合わせ例
よく使う設定の組み合わせ例です。設定時の参考にしてください。
| やりたいこと | 計算方法 | 指定 | 営業日調整 |
|---|---|---|---|
| 当月末を期日にする | 「基準日の当月」 | 「月末」 | 必要に応じて設定 |
| 当月20日を支払日にする | 「基準日の当月」 | 「指定日」に「20」 | 「前営業日」 |
| 30日後を期限にする | 「基準日からの日数」 | 「30」「日」「後」 | 「翌営業日」 |
| 翌月末を納期にする | 「基準日からの月数」 | 「1」「ヶ月」「後」「の」「月末」 | 「翌営業日」 |
| 翌月20日を支払日にする | 「基準日からの月数」 | 「1」「ヶ月」「後」「の」「指定日」に「20」 | 「前営業日」 |
| 3ヶ月後の月初を次回点検日にする | 「基準日からの月数」 | 「3」「ヶ月」「後」「の」「月初(1日)」 | 必要に応じて設定 |
| 1年後を契約満了日にする | 「基準日からの月数」 | 「12」「ヶ月」「後」「の」「指定日」 | 必要に応じて設定 |
💡 「基準日からの月数」で「0」を指定すると、基準日と同じ月が対象になります。
4-8. 使い方の例:受注日から「翌月末払い(休日なら翌営業日)」の支払期日を出す
「受注日」と「支払期日」(どちらも日付フィールド)があるアプリで、支払期日を自動で入れる例です。
- 3-1の手順で設定画面を開き、「日付設定」タブで「+ ルールを追加」をクリックします。
- ルール名に「支払期日の自動設定」と入力します。
- 「基準フィールド」で「受注日」を選びます。
- 「計算方法」で「基準日からの月数」を選び、「1」「ヶ月」「後」「の」「月末」にします。
- 「対象フィールド」で「支払期日」を選び、「対象フィールドを編集不可にする」にチェックを入れます。
- 「計算結果が休日(土日・祝日・会社休日)の場合は営業日に調整する」にチェックを入れ、「翌営業日」を選びます。
- カード下部のプレビューで、意図した日付になっていることを確認します。
- 年末年始などの休業日があれば、「休日設定」タブの「会社休日」に登録します。
- 「設定保存」をクリックし、「設定を保存して、アプリを更新しました」と表示されることを確認します。
- レコードの追加画面で「受注日」に日付を入れると、「支払期日」に翌月末(休日なら翌営業日)が入ります。
たとえば受注日が 2026-12-10 の場合、翌月末は 2027-01-31(日曜日)のため、支払期日は翌営業日の 2027-02-01 になります(土日を休日扱いにしている場合)。
制限事項・注意点
5-1. フィールドに関する制限
- 対象フィールドに指定できるのは「日付」フィールドのみです。「日時」フィールドは指定できません。
- 基準フィールドと対象フィールドは、同じテーブル内である必要があります。メインのフィールドとサブテーブル内のフィールドを組み合わせることはできません。
- 基準フィールドと対象フィールドに、同じフィールドを指定することはできません。
- 有効なルールの中で、同じ対象フィールドを複数のルールで使うことはできません。1つの対象フィールドに対してルールは1つです。
- 基準フィールドに「日時」フィールドを指定した場合、時刻は計算に使用されません。
5-2. 計算に関する制限
- 指定した日がその月に存在しない場合は、その月の最終日に調整されます。
- 内蔵の祝日データは2025年から2030年までです。2031年以降の日付は、祝日として判定されません。土曜日・日曜日・会社休日・会社営業日の判定はこの期間の制限を受けません。
- 営業日調整では、休日が続く場合も営業日に到達するまでずらし続けます。ただし、370日以内に営業日が見つからない場合は、その時点の日付で停止します。
5-3. 動作タイミングに関する制限
- 自動計算は、基準フィールドの値を画面上で変更したときに実行されます。レコードを開いただけでは再計算されません。
- 既存レコードの値を、設定変更後にまとめて再計算する機能はありません。既存レコードへ反映する場合は、レコードを開いて基準フィールドを入力し直してください。
- サブテーブルでは、値を変更した行の日付のみが更新されます。他の行は更新されません。
- レコードの詳細画面(閲覧のみの画面)での動作は該当なしです。
- CSVファイルの読み込みや、API・他のプラグインによる一括更新で基準フィールドが変わっても、対象フィールドは再計算されません。
- 一覧画面のインライン編集では、「対象フィールドを編集不可にする」はインライン編集の開始時には適用されません。
5-4. 休日設定に関する注意
- 「休日設定」タブの内容は、アプリ内のすべてのルールに共通で適用されます。ルールごとに休日を分けることはできません。
- 同じ日付を「会社休日」と「会社営業日」の両方に登録することはできません。
- 「会社営業日」に登録した日は、土曜日・日曜日・祝日・「会社休日」の設定より優先して営業日として扱われます。
5-5. その他の注意
- ルールを無効にしても、すでにレコードへ入力された日付の値は変わりません。
- 「対象フィールドを編集不可にする」を設定した場合でも、他の方法(レコードの一括更新など)で値が変更される可能性があります。
- 「設定読込」を行っただけでは設定は確定しません。「設定保存」を押して確定してください。
困ったときは
6-1. 表示されるメッセージと対処
| メッセージ | 表示される場面 | 対処 |
|---|---|---|
| 入力エラー(ルール#1(ルール名):基準フィールドを選択してください など) | 「設定保存」のとき | 「3-9-1. 保存できないときのメッセージ」の表を見て、該当のルールを直します |
| 設定を保存して、アプリを更新しました | 「設定保存」のあと | 保存とアプリの更新が完了しました。対処は不要です(「アプリを開く」でアプリの一覧画面へ、「設定を続ける」で設定画面に残ります) |
| 設定は保存しましたが、アプリを更新できませんでした | 「設定保存」のあと | 設定は保存されていますが、アプリの更新が済んでいません。「アプリの設定に戻る」を押し、「アプリの設定」画面で「アプリを更新」をクリックします |
| フィールド取得失敗 | 設定画面を開いたとき | アプリのフィールド情報を読み込めませんでした。画面を再読み込みします |
| 削除確認(「(ルール名)」を削除してよろしいですか?) | ルールのゴミ箱アイコンを押したとき | 削除してよければ「削除」をクリックします |
| 日付を選択してください | 会社休日・会社営業日の「+ 追加」を押したとき | カレンダーで日付を選んでから「+ 追加」をクリックします |
| 既に登録されています | 同上 | その日付は登録済みです |
| 会社営業日に登録されているため、休日として登録できません | 会社休日の「+ 追加」 | 先に「会社営業日」からその日付を削除します |
| 会社休日に登録されているため、営業日として登録できません | 会社営業日の「+ 追加」 | 先に「会社休日」からその日付を削除します |
| 設定を読み込みますか? | 「設定読込」でファイルを選んだとき | 現在の設定が上書きされます。よければ「読み込む」をクリックします |
| 設定を読み込みました | 「設定読込」のあと | 内容を確認し、「設定保存」をクリックします。「※ 現在のアプリに存在しないため取り込めなかったフィールドがあります:」と出た場合は、表示されたルールのフィールドを選び直します |
| 読み込みに失敗しました(JSONファイルを解析できませんでした。ファイルの内容を確認してください。) | 「設定読込」のとき | ファイルが壊れていないか確認し、「設定出力」で書き出したファイルを選び直します |
| 設定ファイルの形式が正しくありません(日付計算プラグインでダウンロードした設定ファイルを選択してください。) | 「設定読込」のとき | このプラグインの「設定出力」で書き出したファイルを選びます |
6-2. うまく動かないときの確認ポイント
- アプリの設定の「プラグイン」で、「日付計算プラグイン」が有効になっているか
- 「設定保存」のあと「設定を保存して、アプリを更新しました」と表示されたか(「設定は保存しましたが、アプリを更新できませんでした」と出た場合は「アプリを更新」をクリックする)
- ルールのトグルスイッチがオン(有効)になっているか
- 基準フィールドを、レコードの追加・編集画面で入力・変更したか(レコードを開いただけでは再計算されません)
- 基準フィールドと対象フィールドが同じテーブル内か(メインとサブテーブルの組み合わせは使えません)
- 営業日調整の結果が意図と違うときは、「休日設定」タブの曜日・祝日・会社休日・会社営業日を確認する(祝日データは2025〜2030年分です)
- 設定画面のプレビューで、意図した日付になっているか
6-3. よくある質問
Q. 既に登録済みのレコードにも、まとめて計算結果を入れられますか。
まとめて再計算する機能はありません。
レコードを編集画面で開き、基準フィールドを入力し直すと計算されます。
Q. 対象フィールドを手で直したのに、元に戻ってしまいました。
基準フィールドを変更すると、対象フィールドは再計算した値で上書きされます。
手で直した値を残したいときは、基準フィールドを変更しないか、そのルールを無効にしてください。
Q. 2031年以降の祝日はどうなりますか。
内蔵の祝日データは2025年から2030年までです。2031年以降の日付は祝日として判定されません。
必要な日は、「休日設定」タブの「会社休日」に登録してください。
Q. 同じ対象フィールドに、条件の違う2つのルールを使えますか。
有効なルールの中で、同じ対象フィールドを使えるのは1つだけです。
使い分けたいときは、どちらかのルールを無効にしてください。
Q. 「1ヶ月後の31日」は、31日がない月ではどうなりますか。
その月の最終日になります。たとえば基準日が1月15日なら、2月28日(うるう年は2月29日)になります。