限定したISO期間表記を分数へ変える

できあがるもの

実行ログのJSON配列は[["PT1H30M",90],["PT45M",45],["PT2H",120]]です。完成表の列順は期間表記・分数です。

始める前に

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

手順

1. 新しい検証用Apps Scriptプロジェクトを開きます。既存の業務コードやトリガーには追加せず、下の関数だけを貼り付けて保存します。実在の顧客・案件・金額は使わず、まず記載の入力例のまま進めます。
2. 次の関数はinputを元にoutputを組み立て、完成表の各行をJSON配列としてログに出します。実行する関数名はrunRecipeです。

   コピー

   function runRecipe() {
     const input = [["PT1H30M"],["PT45M"],["PT2H"]];
     const output=input.map(([s])=>{const match=/^PT(?:(\d+)H)?(?:(\d+)M)?$/.exec(s);if(!match||(!match[1]&&!match[2]))throw new Error('期間形式不正');return [s,Number(match[1]||0)*60+Number(match[2]||0)];});
     Logger.log(JSON.stringify(output));
   }

3. PTで始まる整数の時間・分だけを正規表現で読み、分へ統一します。時刻ではなく期間なので、2Hの120分も日付に結び付けず扱えます。 エディタの関数選択でrunRecipeを選んで1回実行し、実行ログを開いてください。シートへの書き込みは行わないため、ファイル一覧やセルを探す必要はありません。
4. 実行ログのJSON配列は[["PT1H30M",90],["PT45M",45],["PT2H",120]]です。完成表の列順は期間表記・分数です。 行の順序と値を両方照合します。この例は日時にローカルの現在時刻を使わないため、別の日に同じ入力で再実行しても同じ結果を得る設計です。
5. ISO期間の全仕様を扱いません。日、秒、小数、年や月は拒否する限定パーサーです。対応外形式をゼロ扱いせずエラーとして止めます。 実務へ広げる場合は入力件数と型を検証し、空配列・境界・重複などの業務ルールを先に決めます。入力例を変える際は元のコードを控え、1項目ずつ結果を比べます。

   できあがる結果

   期間表記	分数
   PT1H30M	90
   PT45M	45
   PT2H	120

   PTで始まる整数の時間・分だけを正規表現で読み、分へ統一します。時刻ではなく期間なので、2Hの120分も日付に結び付けず扱えます。

期待結果と照合する

実行ログのJSON配列は[["PT1H30M",90],["PT45M",45],["PT2H",120]]です。完成表の列順は期間表記・分数です。

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

うまくいかないとき

• ISO期間の全仕様を扱いません。日、秒、小数、年や月は拒否する限定パーサーです。対応外形式をゼロ扱いせずエラーとして止めます。
• Google接続済み環境での実行は未確認です。JavaScriptの構文確認やローカル計算確認は、Googleの実行環境と権限の確認の代わりにはなりません。

止める・元に戻す

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

公式資料・対応範囲

• Google公式：Apps ScriptのV8ランタイム
• Google公式：Loggerの記録方法

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

同じツールで試す

• 数式の計算結果を値だけの控えシートへ保存する
• 経費台帳を部門別に集計して別シートへ出す
• 必須項目の不足だけを行番号付きで一覧にする