日付計算プラグイン

日付・日時フィールドに年、月、日、分を足したり引いたりした結果を別の日付・日時フィールドにセットするプラグインです。
カレンダーPlusプラグインに対応しています。

動作イメージ

基準フィールド（日付または日時フィールド）にプラグイン画面で設定した固定値もしくは、数値フィールドの値を年・月・日・分として加算・減算した結果を反映フィールド（別の日付または日時フィールド）にセットします。
下図では、基準フィールドに対し2年の加算設定を行っています。
基準フィールドの値を変更したタイミングで計算結果を反映フィールドへのセットを行います。

【使用しているkintoneイベント（参考 cybozu developer network）】
レコード追加画面のフィールド値変更時イベント
 レコード編集画面のフィールド値変更時イベント
 レコード一覧画面のインライン編集フィールド値変更時イベント

【使用しているカレンダーPlusのイベント（参考ラジカルブリッジ：Calendar Plus JavaScript APIリファレンス）】
タイトル入力ダイアログからのイベントレコード新規保存前イベント
マウスドラッグによるイベントレコード更新前イベント

プラグイン設定

設定項目	説明
プラグインログログアプリID プラグインエラーが発生した場合	「プラグインログ機能について」のページを参照してください。
基準フィールド	加算や減算の元になる日付または日時フィールドを選択します。
計算方法	＋かーのどちらかを選択します。
±数（フィールド）	数値フィールドから選択します。固定値を入力する場合は「—–」を選択してください。入力される値によって、計算結果が日付として成り立たない値になった場合は、エラーが発生しますので注意してください。
±数（固定値）	加算または減算する値を整数で入力します。数値フィールドの「—–」以外を選択している場合は入力できません。
単位	年、月、日、分のいずれかを選択します。基準フィールドが日付フィールドの場合に「分」を選択すると、0時0分からのプラスマイナスになります。【例】基準：2020/12/01 , ±値:-1分 →反映フィールド：2020/11/30 （2020/12/01 00:00 -1分 = 2020/11/30 23:59）
反映フィールド	計算結果を反映させる日付または日時フィールドを選択します。基準フィールドと反映フィールドのタイプは同じにしてください。フィールドにはユーザーの編集権限が必要です。
カレンダーPlus登録時のみ	いいえ、はいのどちらかを選択します。カレンダーPlus未使用時は「いいえ」を選んでください。標準画面から登録する場合とカレンダーPlusから登録する場合で、反映フィールドを変えたい場合に「はい」を選択します。

制限事項等

ライセンス有効状況確認のため、外部サーバーと通信を行います。
同一アプリに他のJavaScriptカスタマイズやプラグインが設定されている場合、正しく動作しない可能性があります。正しく動作しない場合は、他のJavaScriptカスタマイズやプラグインを外してご利用ください。
kintoneの画面操作で動作します。連携サービスからの値更新では、動作しません。
カレンダーPlusプラグイン対応について
カレンダーPlusの画面で登録変更を行ったレコードについては、カレンダーPlusの開始日時のフィールドまたは終了日時のフィールドに設定されている基準フィールドのみ動作します。

例）下記設定でカレンダーPlus画面で新規登録を行った場合は、日付計算プラグインの設定①は動作しますが、②は動作しません。
日付計算プラグインの②の動作が動かないため、納入日に初期日付が設定されていたとしても、在庫計上日はセットされません。
【日付計算プラグインの設定】
①基準フィールド：製造日　反映フィールド：点検日
②基準フィールド：納入日　反映フィールド：在庫計上日
【カレンダーPlusの設定】
開始日時のフィールド：製造日　終了日時のフィールド：有効終了日

プラグインダウンロード

利用規約に同意いただいたうえで、ダウンロード・ご利用ください。

警告メッセージが表示されますが、ライセンスキー無しでも無期限でトライアル可能ですので、お試しください。

プラグインをダウンロード

購入ご希望の場合はこちら

使い方の参考例をこの記事で紹介しています！

更新情報

日付	バージョン	内容
2020/09/19	1	初回リリース（カレンダーPlus v12.0で動作確認）
2020/12/08	2	・単位に「分」を追加・±数を固定値に加え、数値フィールドの指定も可とする・カレンダーPlusから登録された時のみ起動するオプション追加・カレンダーPlusから登録された時、反映フィールドが参照できない場合はエラーにするよう変更・基準フィールドに初期値が設定されている時のエラー検知不具合修正

ログ記載内容・想定されるエラー等

値変更イベントカレンダーPlusイベントプラグイン設定保存イベント

【イベント】app.record.create.change.基準フィールド, app.record.edit.change.基準フィールド, app.record.index.edit.change.基準フィールド,app.record.create.change.±数（フィールド） app.record.edit.change.±数（フィールド）, app.record.index.edit.change.±数（フィールド）

想定されるエラー	ログ記録
・フィールドが削除された・フィールドコードが変更された・フィールドの参照権限がない・日付計算時に想定外エラーが発生 ※エラー判定となりますが、更新ボタンを押すと反映先フィールドの値は計算されないまま登録されます。	Error
・反映先フィールドに更新権限がない ※エラーにはならず、反映先フィールドの値は計算されないまま登録されます。	なし
・計算結果が日付としてありえない値になった場合 ※kintoneのエラーメッセージ「カスタマイズ用のJavaScriptの実行時にエラーが発生しました。アプリの管理者にお問い合わせください。-event.record[‘反映フィールド’].valueが不正です。」が表示され、反映先フィールドの値は更新されません。	なし

【イベント（カレンダーPlus）】cp.create.submit, cp.edit.submit

想定されるエラー	ログ記録
・フィールドが削除された・フィールドコードが変更された・フィールドの参照権限がない・日付計算時に想定外エラーが発生 ※日付計算プラグイン設定のプラグインエラーが発生した場合を「処理続行」にすると、反映フィールドは更新されませんが、カレンダーPlusのデータ更新は行います。「処理停止」にすると、カレンダーPlusの更新も停止します。	Error
・反映先フィールドに更新権限がない ※カレンダーPlusのエラーメッセージ「編集権限がありません」が表示され、レコード登録できません。なお、かりんこラボプラグインではエラーが検知されません。	なし
・計算結果が日付としてありえない値になった場合 ※カレンダーPlusのエラーメッセージ「保存処理に失敗しました。入力内容が正しくありません。1,000年以上9,999年以下の日時でなければなりません。日時はISO8601形式の必要があります。」が表示され、レコード登録できません。なお、かりんこラボプラグインではエラーが検知されません。	なし

【イベント（プラグイン設定保存）】caryncolabo.plugin.config.submit

ログ内容	ログ記録
・設定内容がJSON形式で書き込まれます。	Information