しごと自動化レシピ

WORK RECIPE GAS

滞留日数を基準日固定で区分する

現在時刻でなく固定の基準日を使い、受付からの経過日を区分します。UTCの午前0時で差を取るため、実行環境の日付設定に左右されにくい例です。 外部送信やシート更新をせず、コード内の架空データから完成表のJSONを作ります。

案件・受付日 → 案件・滞留日・区分(作業の流れを表す概念図)
実行確認の記録なし

公式資料を参照して構成した手順です。本記事の操作・コードの実行は未確認です。小さな入力例で期待結果を確かめてから利用してください。

できあがるもの

実行ログのJSON配列は[["A",1,"7日以内"],["B",9,"8〜30日"],["C",48,"31日以上"]]です。完成表の列順は案件・滞留日・区分です。

始める前に

  • Googleアカウントで新しいApps Scriptプロジェクトを作成し、V8ランタイムを使用します。対象はエディタで手動実行する通常の関数です。
  • このコードはLoggerとJavaScriptの標準機能だけを使います。シートID、APIキー、トリガー、メール送信権限は不要です。
入力例

シートからは読み取りません。コード内のinputが入力表で、列順は案件・受付日です。架空の値は[["A", "2026-10-18"], ["B", "2026-10-10"], ["C", "2026-09-01"]]です。

入力例を表で確認する
入力例
案件受付日
A2026-10-18
B2026-10-10
C2026-09-01

掲載手順と同じ小さな入力例です。まずは、この値で試してください。

手順

  1. 新しい検証用Apps Scriptプロジェクトを開きます。既存の業務コードやトリガーには追加せず、下の関数だけを貼り付けて保存します。実在の顧客・案件・金額は使わず、まず記載の入力例のまま進めます。
  2. 次の関数はinputを元にoutputを組み立て、完成表の各行をJSON配列としてログに出します。実行する関数名はrunRecipeです。
    function runRecipe() {
      const input = [["A","2026-10-18"],["B","2026-10-10"],["C","2026-09-01"]];
      const day=s=>Date.parse(s+'T00:00:00Z')/86400000, base=day('2026-10-19');
      const output=input.map(([id,date])=>{const age=base-day(date);return [id,age,age<=7?'7日以内':age<=30?'8〜30日':'31日以上'];});
      Logger.log(JSON.stringify(output));
    }
  3. 現在時刻でなく固定の基準日を使い、受付からの経過日を区分します。UTCの午前0時で差を取るため、実行環境の日付設定に左右されにくい例です。 エディタの関数選択でrunRecipeを選んで1回実行し、実行ログを開いてください。シートへの書き込みは行わないため、ファイル一覧やセルを探す必要はありません。
  4. 実行ログのJSON配列は[["A",1,"7日以内"],["B",9,"8〜30日"],["C",48,"31日以上"]]です。完成表の列順は案件・滞留日・区分です。 行の順序と値を両方照合します。この例は日時にローカルの現在時刻を使わないため、別の日に同じ入力で再実行しても同じ結果を得る設計です。
  5. 日付は有効なISO日付で未来日を含めない前提です。営業日ではなく暦日で、受付日を0日目とする区分です。 実務へ広げる場合は入力件数と型を検証し、空配列・境界・重複などの業務ルールを先に決めます。入力例を変える際は元のコードを控え、1項目ずつ結果を比べます。
    できあがる結果を表で確認する
    できあがる結果
    案件滞留日区分
    A17日以内
    B98〜30日
    C4831日以上

    現在時刻でなく固定の基準日を使い、受付からの経過日を区分します。UTCの午前0時で差を取るため、実行環境の日付設定に左右されにくい例です。

期待結果と照合する

実行ログのJSON配列は[["A",1,"7日以内"],["B",9,"8〜30日"],["C",48,"31日以上"]]です。完成表の列順は案件・滞留日・区分です。

まずこの入力例で確認し、件数や値が一致しているかを見ます。完了表示だけで判断せず、重複・空欄・対象外データも残っていないか確認してください。

うまくいかないとき

  • 日付は有効なISO日付で未来日を含めない前提です。営業日ではなく暦日で、受付日を0日目とする区分です。
  • Google接続済み環境での実行は未確認です。JavaScriptの構文確認やローカル計算確認は、Googleの実行環境と権限の確認の代わりにはなりません。

止める・元に戻す

関数を実行してもシート・メール・外部サービスは変更しません。追加したrunRecipe関数とテスト用プロジェクトを不要に応じて削除してください。ログに機密値を入れないことを前提とします。

公式資料・対応範囲

参照日:2026-10-19。公式資料の一般的な機能説明と、本記事固有の入力例の実行検証は別です。実務での短縮時間や効果は未計測です。

同じツールで試す

GASの記事一覧へ →