【GAS入門#29】日付や時刻を思い通りの見た目に!Utilities.formatDate()の使い方とフォーマットパターン完全解説

Google Apps Script(GAS)で日付や時間を扱っているとき、こんな経験はありませんか?

プログラム実行時の日時を取得してログに出力したり、スプレッドシートやメールに書き出そうとしたら、画面に Thu Jan 29 2026 14:30:00 GMT+0900 (Japan Standard Time) のような長〜い英語の文字列が表示されて面食らってしまった…というお悩みです。

この長くて読みづらい日付データを、私たちが日常で見慣れている 「2026/01/29」 や 「2026年1月29日(木) 14時30分」 といった綺麗で分かりやすい表記に一瞬で変換してくれるのが、今回解説する Utilities.formatDate()(ユーティリティーズ・フォーマット・デイト) です!

今回は、GASで日付を自由自在にデザインするための最重要メソッド Utilities.formatDate() の基本文法から、2桁年・元号・英語曜日・英語月名・さらには和風月名(弥生・卯月など)の表現方法、初心者がハマりやすいタイムゾーンの罠まで、どこよりも詳しく・わかりやすく解説します!

1. そもそも Utilities.formatDate() とは?

Utilities.formatDate() は、GASに標準で用意されている 「日付データを指定したフォーマットの文字列に整形(変換)する命令」 です。

コードの分解と読み方

呪文のように見えますが、言葉を細かく分解してみると構造はとてもシンプルです。

Utilities.formatDate(date, timeZone, format)
  • Utilities(ユーティリティーズ)GASでよく使う便利な小道具(日付変換、暗号化、ファイル圧縮など)が詰まった「便利ツール箱」のような存在です。
  • .formatDate()(フォーマット・デイト)便利ツール箱の中にある「日付の見た目を整えてね!」と頼む専用の命令(メソッド)です。

「翻訳機」のイメージで理解しよう!

GASの世界で new Date() を使って取得した日付データは、コンピュータにとって扱いやすい「日時オブジェクト(生のデータ)」です。これは人間でいうと 「翻訳前の外国語」 のような状態です。

Utilities.formatDate() は、その生のデータを私たちが読める 「綺麗な日本語や好みのデザインの文字」に翻訳してくれる通訳さん の役割を果たしています。

第5回の getValue() や第6回の setValue()、第7回の appendRow() の解説でも触れましたが、スプレッドシートやメール、カレンダーに日時を出力する前にこの「通訳(整形)」を挟むことで、誰が見ても一目でわかる綺麗な自動化システムが作れるようになります!

2. 基本構文と3つの引数(ひきすう)をマスターしよう

Utilities.formatDate() を使うときは、カッコの中に 3つの情報(引数) を順番に渡してあげます。

var formattedDate = Utilities.formatDate(日時データ, タイムゾーン, フォーマットパターン);

この3つの引数の役割をしっかり確認しておきましょう。

引数の順番名称役割と指定する内容具体的な書き方例
第1引数date変換したい元の日時データ(Dateオブジェクト)new Date() や セルから取得した日付
第2引数timeZoneどこの国の基準時間で計算するか(タイムゾーン)"Asia/Tokyo" や Session.getScriptTimeZone()
第3引数formatどんな見た目(形式)に変換したいかのルール"yyyy/MM/dd HH:mm:ss" など

3. STEP1:【実践】2026年1月29日の日付を綺麗な文字列に変えてみよう!

論より証拠!実際にコードを書いて動かしてみましょう。

基準日時として 2026年1月29日 14時30分00秒 のデータを作成し、それを「2026/01/29 14:30:00」という綺麗な表記に変換してみます。

1. コードを入力する

スプレッドシートのメニューバーから 「拡張機能」 > 「Apps Script」 を開き、以下のコードを貼り付けます。第1回で学んだ Logger.log() を使って実行ログに結果を出力します。

function formatMyDate() {
  // ① 基準となる日時データを用意する(2026年1月29日 14:30:00)
  // ※JavaScriptの月は「0」が1月、「1」が2月のため、1月は「0」と指定します
  var targetDate = new Date(2026, 0, 29, 14, 30, 0);
  
  // ② タイムゾーンを取得する(日本の標準時)
  var timeZone = "Asia/Tokyo";
  
  // ③ 見た目のルール(フォーマット)を決める
  var pattern = "yyyy/MM/dd HH:mm:ss";
  
  // ④ Utilities.formatDate で綺麗に整形する!
  var result = Utilities.formatDate(targetDate, timeZone, pattern);
  
  // ⑤ 結果をログに出力してみる
  Logger.log("変換前の生データ: " + targetDate);
  Logger.log("変換後の綺麗データ: " + result);
}

2. 実行結果を確認する

コードを保存し、formatMyDate を実行してみましょう!画面下の実行ログに次のように表示されれば大成功です。

情報	変換前の生データ: Thu Jan 29 2026 14:30:00 GMT+0900 (Japan Standard Time)
情報	変換後の綺麗データ: 2026/01/29 14:30:00

変換前の長〜い英語表記が、スッキリとした「2026/01/29 14:30:00」に見事に生まれ変わりましたね!

4. STEP2:フォーマットパターン記号完全攻略ガイド

Utilities.formatDate() の第3引数で使うアルファベット記号(パターン識別子)を覚えると、日付の表現形式を無限にカスタマイズできるようになります。

ここでは、実務でよく使う基本的なパターンから、リクエストの多い 「2桁年」「元号」「英語曜日」「英語月名」「和風月名(弥生・卯月など)」 の指定方法までを網羅して徹底解説します!

① 年(Year)の指定方法:西暦4桁・西暦2桁

年を表す基本記号には、4桁表記の yyyy と、下2桁だけを表す yy があります。

記号パターン意味・説明2026年1月29日の出力例
yyyy西暦(4桁)2026
yy西暦(下2桁)26

コード例:2桁年の表記を使ってみよう!

function formatYearExamples() {
  var targetDate = new Date(2026, 0, 29); // 2026年1月29日
  var timeZone = "Asia/Tokyo";

  // 1. 一般的な4桁年
  var y4 = Utilities.formatDate(targetDate, timeZone, "yyyy年MM月dd日");
  // ➡ 2026年01月29日

  // 2. スマートな2桁年(2桁の年表記)
  var y2 = Utilities.formatDate(targetDate, timeZone, "yy/MM/dd");
  // ➡ 26/01/29
  
  Logger.log("4桁年: " + y4);
  Logger.log("2桁年: " + y2);
}

💡実務で役立つ!和暦(令和・平成など)を出力するテクニック

「令和8年」のように元号付きの和暦を出力したい場合、GASの標準記号(G など)を使うと、英語環境の影響で AD26年 のように変換されてしまうことがあり、実務ではあまり使い物になりません。 そのため、和暦への変換は「元号の判定関数を自作する」のがもっとも確実でよく使われるプロのテクニックです。以下に、明治以降のすべての元号に対応し、1年目を「元年」と表記する実用的な関数をご紹介します。

// 日付オブジェクトを渡すと、明治以降の和暦文字列(例:令和8年)を返す関数
function toJapaneseEra(dateObj) {
  var year = dateObj.getFullYear();
  var month = dateObj.getMonth() + 1;
  var day = dateObj.getDate();
  
  // 日付を「YYYYMMDD」の数値(例:20260129)にして比較しやすくする
  var dateNumber = year * 10000 + month * 100 + day;

  var eraName = "";
  var eraYear = 0;

  // 各元号の開始日(YYYYMMDD)で判定
  if (dateNumber >= 20190501) {
    eraName = "令和";
    eraYear = year - 2018;
  } else if (dateNumber >= 19890108) {
    eraName = "平成";
    eraYear = year - 1988;
  } else if (dateNumber >= 19261225) {
    eraName = "昭和";
    eraYear = year - 1925;
  } else if (dateNumber >= 19120730) {
    eraName = "大正";
    eraYear = year - 1911;
  } else if (dateNumber >= 18680125) { // 明治(※新暦換算の目安日)
    eraName = "明治";
    eraYear = year - 1867;
  } else {
    return "江戸時代以前"; // 明治より前は対象外とする
  }

  // 1年目は「元年」とする表記調整
  var eraYearStr = (eraYear === 1) ? "元" : eraYear;
  
  return eraName + eraYearStr + "年";
}

このような自作関数を使って、Utilities.formatDate() では「月日」だけを整形し、和暦の「年」は自作関数で組み合わせて合体させるのが、実務で絶対にバグらない最強の手法です!

// 実際に使ってみる例
function testEra() {
  var targetDate = new Date(2026, 0, 29); // 2026年1月29日
  
  // 自作関数で「令和8年」を作り、Utilities.formatDateで「01月29日」を作る
  var eraText = toJapaneseEra(targetDate);
  var mdText = Utilities.formatDate(targetDate, "Asia/Tokyo", "MM月dd日");
  
  Logger.log("和暦表記: " + eraText + mdText);
  // ➡ 実行結果:和暦表記: 令和8年01月29日
}

② 月(Month)の指定方法:数字・英語略呼称・英語フル表記・和風月名

月を表す記号は 必ず大文字の M を使います(小文字の m は「分」になってしまうため注意!)。

記号パターン意味・説明1月(Jan)の出力例3月(Mar)の出力例4月(Apr)の出力例
MM2桁数字(ゼロ埋め)010304
M1桁〜2桁数字134
MMM英語月名(3文字略称)JanMarApr
MMMM英語月名(フルスペル)JanuaryMarchApril

英語月名(March, April / Mar, Apr)を出力するコード例

海外向けのレポート作成やWebサイトの表記で、「March」や「Mar」といった英語の月表記を使いたいケースもありますよね。

function formatEnglishMonths() {
  var dateJan = new Date(2026, 0, 29); // 1月29日
  var dateMar = new Date(2026, 2, 15); // 3月15日
  var dateApr = new Date(2026, 3, 10); // 4月10日
  var tz = "Asia/Tokyo";

  // 3文字略称(MMM): Jan, Mar, Apr
  Logger.log("1月(略称): " + Utilities.formatDate(dateJan, tz, "MMM dd, yyyy")); // Jan 29, 2026
  Logger.log("3月(略称): " + Utilities.formatDate(dateMar, tz, "MMM dd, yyyy")); // Mar 15, 2026
  Logger.log("4月(略称): " + Utilities.formatDate(dateApr, tz, "MMM dd, yyyy")); // Apr 10, 2026

  // フルスペル(MMMM): January, March, April
  Logger.log("3月(フル): " + Utilities.formatDate(dateMar, tz, "MMMM dd, yyyy")); // March 15, 2026
  Logger.log("4月(フル): " + Utilities.formatDate(dateApr, tz, "MMMM dd, yyyy")); // April 10, 2026
}

弥生、卯月のような「和風月名(旧暦月名)」を出すテクニック

スプレッドシートで和風のイベント企画書を作るときや、「弥生の限定メニュー」「卯月の定期メンテナンス」といった和風月名を出したいときがありますよね。

残念ながら Utilities.formatDate() の標準記号単体では「弥生」や「卯月」を直接出力する記法はありません。しかし、GASで配列(お弁当箱)を用意してマッピングする ことで、超簡単かつスマートに和風月名を取得できます!

function formatWafuMonth() {
  var targetDate = new Date(2026, 2, 15); // 2026年3月15日
  
  // 和風月名(和名)の12ヶ月配列を準備する
  var wafuMonths = [
    "睦月", "如月", "弥生", "卯月", "皐月", "水無月",
    "文月", "葉月", "長月", "神無月", "霜月", "師走"
  ];
  
  // targetDate.getMonth() で月のインデックス(0〜11)を取得
  var monthIndex = targetDate.getMonth(); 
  var wafuName = wafuMonths[monthIndex]; // 3月(インデックス2)なら「弥生」
  
  // 日付の残りを Utilities.formatDate で整形して合体!
  var dayPart = Utilities.formatDate(targetDate, "Asia/Tokyo", "dd日");
  
  Logger.log("和風月名表記: " + wafuName + " " + dayPart);
  // ➡ 実行結果:和風月名表記: 弥生 15日
}

このように標準機能とシンプルなJavaScriptの配列を組み合わせることで、どんな特殊な月表記にも柔軟に対応できますよ!

③ 曜日(Day of week)の指定方法:Sun, Sat などの英語表記

曜日を表す記号は E を使います。

記号パターン意味・説明2026/1/29(木)の例日曜日(Sun)の例土曜日(Sat)の例
E または EEE英語曜日(3文字略称)ThuSunSat
EEEE英語曜日(フルスペル)ThursdaySundaySaturday

コード例:Sun, Sat などの曜日表記を取り出す

function formatDayOfWeekExamples() {
  var dateThu = new Date(2026, 0, 29); // 2026年1月29日(木)
  var dateSun = new Date(2026, 0, 25); // 2026年1月25日(日)
  var dateSat = new Date(2026, 0, 31); // 2026年1月31日(土)
  var tz = "Asia/Tokyo";

  // EEE を使うと Sun, Sat, Thu のような英語3文字表記が得られる
  Logger.log("木曜日: " + Utilities.formatDate(dateThu, tz, "yyyy-MM-dd (EEE)")); // 2026-01-29 (Thu)
  Logger.log("日曜日: " + Utilities.formatDate(dateSun, tz, "yyyy-MM-dd (EEE)")); // 2026-01-25 (Sun)
  Logger.log("土曜日: " + Utilities.formatDate(dateSat, tz, "yyyy-MM-dd (EEE)")); // 2026-01-31 (Sat)
}

💡日本語の曜日(「木」「木曜日」)を出したい時は?

GASで日本語の曜日を出したい場合は、前述の和風月名と同様に var weekNames = ["日", "月", "火", "水", "木", "金", "土"]; という配列を作成し、weekNames[targetDate.getDay()] で取り出すのが最も確実で美しい方法です!

④ 日・時間・分・秒の指定方法一覧まとめ

最後に、日付と時間の細かいパーツを一覧表でまとめておきます。組み合わせの辞書として活用してくださいね。

項目記号意味2026/1/29 14:05:09 の例
日dd2桁の日付(ゼロ埋め)29
d1〜2桁の日付29
時HH24時間表記(2桁)14
hh12時間表記(2桁)02
分mm2桁の「分」(小文字!)05
秒ss2桁の「秒」09

5. 初心者が絶対につまずく!4大トラップと完全解決策

Utilities.formatDate() を使っていると、誰もが一度はハマる「定番の落とし穴」があります。あらかじめ知っておくことで、トラブルを未然に防ぎましょう!

トラップ1:タイムゾーンが9時間ずれて前日の日付になってしまう!

「2026年1月29日 朝8時」の日付を変換したのに、なぜか「2026年1月28日 23時(夜)」のように 9時間遅れた前日の日時 が出力されてしまう現象です。

【原因】

第2引数のタイムゾーンに "GMT"(世界標準時)を指定してしまっていることが原因です。日本は世界標準時より 9時間進んでいる(JST = GMT+9) ため、GMT のまま変換すると9時間過去にタイムスリップしてしまいます。

【解決策】

日本の標準時を指定したい場合は、必ず "Asia/Tokyo" を指定するか、GASプロジェクトの設定に基づいた Session.getScriptTimeZone() を使いましょう!

// ✕ 間違い(9時間ずれて前日になるリスクあり)
var result = Utilities.formatDate(new Date(), "GMT", "yyyy/MM/dd HH:mm:ss");

// ◯ 正しい(日本時間で正確に出力される)
var result = Utilities.formatDate(new Date(), "Asia/Tokyo", "yyyy/MM/dd HH:mm:ss");

// ◯ こちらもおすすめ(スクリプトのタイムゾーンを自動取得)
var result = Utilities.formatDate(new Date(), Session.getScriptTimeZone(), "yyyy/MM/dd HH:mm:ss");

トラップ2:大文字の MM と 小文字の mm を間違えて時刻がおかしくなる!

プログラミング初心者の事故率No.1のミスです!

// ✕ 危険なミス!
var wrongDate = Utilities.formatDate(new Date(), "Asia/Tokyo", "yyyy/mm/dd HH:MM:ss");

これを実行すると、例えば「2026年1月29日 14時30分」が 「2026/30/29 14:01:00」 のように、月と分が逆転した支離滅裂な日付になってしまいます。

  • MM(大文字2つ) ➡ 月(Month)
  • mm(小文字2つ) ➡ 分(minute)

アルファベットの大文字・小文字は厳密に区別されます。「月は大文字!分は小文字!」と暗記しておきましょう。

トラップ3:Dateオブジェクトではなく「ただの文字列」を渡してエラーになる

スプレッドシートのセルから取得した日付を Utilities.formatDate() に渡したとき、以下のような赤文字のエラーが出ることがあります。

Exception: The parameters (String,String,String) don't match the method signature for Utilities.formatDate.

【原因】

第1引数には Dateオブジェクト(日付データ) を渡す必要があります。スプレッドシートのセルに入っている値が「文字(String)」として認識されている場合、「文字を日付に変換することはできません!」とお叱りを受けてしまうのです。

【解決策】

new Date(セルの値) を挟んで、一度本物のDateオブジェクトに変換してから Utilities.formatDate() に渡しましょう。

var rawValue = sheet.getRange("A2").getValue(); // セルから取得
var dateObj = new Date(rawValue); // Dateオブジェクトに変換!
var formatted = Utilities.formatDate(dateObj, "Asia/Tokyo", "yyyy/MM/dd");

トラップ4:フォーマット文字列の引用符(” “)を忘れてエラーになる

第3引数のパターンルール(例:yyyy/MM/dd)を、ダブルクォーテーション " で囲まずに書いてしまうエラーです。

// ✕ NG(変数だと勘違いされてエラーになる)
Utilities.formatDate(new Date(), "Asia/Tokyo", yyyy/MM/dd);

// ◯ OK(必ず文字列として " " で囲む)
Utilities.formatDate(new Date(), "Asia/Tokyo", "yyyy/MM/dd");

6. 実務で役立つ応用パターン3選

単に日付を表示するだけでなく、実務の自動化ツールでよく使われる3つの発展的な書き方をご紹介します!

応用①:ログ記録やファイル名用のタイムスタンプを作成する

GASで自動生成したPDFファイルやGoogleドキュメントに「20260129_143000_札幌オフィス日報」のように日時を付与したい時、記号(スラッシュやコロン)を含めない英数字のみのフォーマットが大活躍します。

function createTimestampFileName() {
  var now = new Date();
  
  // ファイル名に使いやすい「年月日_時分秒」のフォーマット
  var timeStamp = Utilities.formatDate(now, "Asia/Tokyo", "yyyyMMdd_HHmmss");
  
  var fileName = timeStamp + "_札幌オフィス業務日報.pdf";
  Logger.log("生成されたファイル名: " + fileName);
  // ➡ 実行結果:20260129_143000_札幌オフィス業務日報.pdf
}

応用②:スプレッドシートの最終行へ綺麗な日付形式で追記する(appendRow + formatDate)

第7回で学んだ Sheet.appendRow() を使って売上や出張経費のログを記録する際、Utilities.formatDate() であらかじめ整形した文字列を配列に入れておくと、見た目が完璧に統一された綺麗な表が作れます!

function addCleanLogRecord() {
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  var now = new Date();
  
  // 「2026/01/29 (Thu) 14:30」の形式に整える
  var formattedDate = Utilities.formatDate(now, "Asia/Tokyo", "yyyy/MM/dd (EEE) HH:mm");
  
  // 配列にしてスプレッドシートの末尾に追記!
  sheet.appendRow([formattedDate, "高橋", "札幌駅〜新千歳空港 JR移動費", 1590]);
  
  Logger.log("綺麗な日時で出張ログを追記しました!");
}

応用③:モーダルダイアログのメッセージに日時をわかりやすく埋め込む

第28回で学んだ Ui.showModalDialog() や Ui.alert() でユーザーに確認画面を出す際、見やすい日時表記を挟むと操作ミスを防ぐことができます。

function showConfirmDialog() {
  var ui = SpreadsheetApp.getUi();
  var now = new Date();
  var dateStr = Utilities.formatDate(now, "Asia/Tokyo", "yyyy年MM月dd日 HH時mm分");
  
  ui.alert(
    "実行確認",
    "現在時刻(" + dateStr + ")基準で全データの自動集計を開始しますか?",
    ui.ButtonSet.YES_NO
  );
}

7. まとめ&次回予告

今回は、GASで日付や時刻を思い通りの見た目にデザインする Utilities.formatDate() について徹底解説しました!

今日の重要ポイントおさらい

  1. Utilities.formatDate(date, timeZone, format) で日付を綺麗な文字列に変換できる
  2. タイムゾーンには原則 "Asia/Tokyo" または Session.getScriptTimeZone() を使う
  3. yyyy(4桁年)、yy(2桁年)、G(元号)で年表記を自由自在にコントロール
  4. 月は大文字 MM(数字)/ MMM(Mar, Apr)/ MMMM(March, April)、分は小文字 mm
  5. 曜日 EEE で Sun, Sat などの英語表記、配列を使えば「弥生・卯月」などの和風月名も簡単に表現可能!

日付データは業務自動化のあらゆる場面(メール送信、レポート作成、ファイル管理、スプレッドシート記録)で必ず登場します。今回学んだフォーマットパターンを使いこなして、誰が見ても見やすい洗練されたシステムを目指しましょう!

次回予告

さて、全30回にわたってお届けしてきたフェーズ3(自動化・UI拡張・エラー処理)も次回でいよいよ区切りとなります!

次回第30回は、プログラム実行中の予期せぬエラーで処理が強制終了してしまうのを防ぐ Try...Catch(トラッチ・キャッチ) を解説します!

「万が一ファイルが見つからなくても、止まらずにエラーログを残して最後まで走り切る」という、実務で絶対に倒れない頑丈なプロ級プログラムの書き方を学びましょう。お楽しみに!