スプレッドシートでは「2026/11/18」と見えている日付を、GAS(Google Apps Script)でメールの本文や別のシートに入れたら、こんな形になってしまった。
・Wed Nov 18 2026 00:00:00 GMT+0900 (日本標準時)
・2026-11-17T15:00:00.000Z(1 日前になっている)
コードの書き間違いではなく、GAS が日付を「日付の値(Date)」として受け取っているために起きます。この記事では、見え方ごとの原因と、シートで見えているのと同じ日付にする書き方をまとめました。
■ 見え方から原因を探す
・英語の長い形(Wed Nov 18 …)になる → 日付の値を、そのまま文字につないでいる
・「…T15:00:00.000Z」で 1 日前になる → JSON などで、世界標準時(日本より 9 時間前)の形にされている
・日付が 1 日ずれる・時刻が 9 時間ずれる → スクリプトとスプレッドシートのタイムゾーンが違う
・46000 のような数字になる → セルの表示形式が「数字」になっている(シートの「表示形式 → 数字 → 日付」で直る)
■ 直し方:日付を「文字」にしてから使う
次の関数を使うと、日付のセルを、シートで見えているのと同じ日付の文字にできます。スプレッドシートのタイムゾーンを使うので、ずれません。
function toDateText(value, format) {
if (value === '' || value === null) return '';
if (value instanceof Date) {
const tz = SpreadsheetApp.getActiveSpreadsheet().getSpreadsheetTimeZone();
return Utilities.formatDate(value, tz, format || 'yyyy/MM/dd');
}
return String(value); // 文字として入っている日付は、そのまま使う
}
使い方の例です。A 列に名前、B 列に期限が入った「一覧」シートから、お知らせの文を作ります。
function buildNotices() {
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('一覧');
const last = sheet.getLastRow();
if (last < 2) return [];
const rows = sheet.getRange(2, 1, last - 1, 2).getValues();
return rows
.filter(row => row[0] !== '')
.map(row => row[0] + ' 様 期限:' + toDateText(row[1]));
}
これで「山田 様 期限:2026/11/18」のようになります。期限が空の行や、日付が文字で入っている行が混ざっていても止まりません。時刻も入れたいときは toDateText(row[1], 'yyyy/MM/dd HH:mm') のように書式を渡します。
■ もっと手軽な方法:getDisplayValues()
getValues() の代わりに getDisplayValues() を使うと、セルに「見えているとおりの文字」で受け取れます。メールに書くだけなら、これがいちばん簡単です。
ただし、次のときは向きません。
・日付で並べ替えたり、「今日より前か」を比べたりしたいとき(文字なので比べられません)
・シートの表示形式をあとで変えたとき(受け取る文字も変わります)
比べたり計算したりするときは getValues() の日付の値のまま使い、最後に書き出すときだけ toDateText で文字にするのが安全です。
■ タイムゾーンをそろえる
古いスクリプトや、人からもらったスクリプトでは、スクリプトのタイムゾーンが日本になっていないことがあります。次の 2 か所が「(GMT+09:00) 東京」になっているか確かめてください。
・スプレッドシート:「ファイル → 設定 → タイムゾーン」
・Apps Script:左の歯車「プロジェクトの設定 → タイムゾーン」
■ つまずきやすいところ
・Utilities.formatDate の書式は、月が大文字の MM、分が小文字の mm です。逆にすると「分」が入ってしまいます
・JSON.stringify は、日付をいつも世界標準時の形にします。日付を JSON に入れるときは、先に toDateText で文字にしておきます
・試すときは、本番のシートのコピーで試すと安心です
■ 自分で直すのが大変なときは
「日付がずれた原因が分からない」「AI に作ってもらったコードの日付がおかしい」といったときは、次の出品でお手伝いしています。
あわせて読みたい:
この記事は、AI(Claude)の助けを借りて書いています。コードは、テスト用のデータで動きを確かめてから載せています。