GASのUtilities.formatDateで
日付を思い通りに整形する方法

function showRawDate() {
  const now = new Date();

  // そのまま出すと読みづらく、環境で表示も変わる
  Logger.log(now); // 例: Sat Jul 18 2026 09:30:00 GMT+0900 (JST)

  // formatDate なら好きな形の文字列にできる
  const text = Utilities.formatDate(now, "Asia/Tokyo", "yyyy/MM/dd HH:mm:ss");
  Logger.log(text); // 例: 2026/07/18 09:30:00
}

function formatBasics() {
  const date = new Date(2026, 6, 18, 9, 5, 3); // 2026年7月18日 09:05:03（月は0始まり）
  const tz = "Asia/Tokyo";

  Logger.log(Utilities.formatDate(date, tz, "yyyy/MM/dd"));        // 2026/07/18
  Logger.log(Utilities.formatDate(date, tz, "yyyy年MM月dd日"));     // 2026年07月18日
  Logger.log(Utilities.formatDate(date, tz, "HH:mm:ss"));          // 09:05:03
  Logger.log(Utilities.formatDate(date, tz, "yyyyMMdd_HHmmss"));   // 20260718_090503
  Logger.log(Utilities.formatDate(date, tz, "yyyy/MM/dd HH:mm")); // 2026/07/18 09:05
}

// よく使う書式パターン（大文字・小文字に注意）
// yyyy … 西暦4桁 (2026)
// yy   … 西暦2桁 (26)
// MM   … 月2桁   (07)   ← 大文字は「月」
// dd   … 日2桁   (18)
// HH   … 時 24h  (09)
// hh   … 時 12h  (09)
// mm   … 分2桁   (05)   ← 小文字は「分」
// ss   … 秒2桁   (03)
// EEE  … 曜日英語 (Sat)
// a    … 午前/午後 (AM/PM)

function patternSample() {
  const date = new Date();
  const tz = "Asia/Tokyo";
  Logger.log(Utilities.formatDate(date, tz, "yyyy-MM-dd (EEE) a hh:mm"));
  // 例: 2026-07-18 (Sat) AM 09:30
}

const WEEKDAYS_JP = ["日", "月", "火", "水", "木", "金", "土"];

function formatWithJapaneseWeekday(date) {
  const tz = "Asia/Tokyo";
  const ymd = Utilities.formatDate(date, tz, "yyyy年MM月dd日");
  const w = WEEKDAYS_JP[date.getDay()]; // getDay(): 日=0 〜 土=6

  return ymd + "（" + w + "）"; // 例: 2026年07月18日（土）
}

function testWeekday() {
  Logger.log(formatWithJapaneseWeekday(new Date(2026, 6, 18)));
}

function timezoneMatters() {
  const date = new Date(2026, 6, 18, 1, 0, 0); // 7/18 01:00（日本時間）

  // UTC で整形すると9時間前になり、日付が前日にずれる
  Logger.log(Utilities.formatDate(date, "UTC", "yyyy/MM/dd HH:mm"));
  // 2026/07/17 16:00

  // Asia/Tokyo を指定すれば日本時間のまま
  Logger.log(Utilities.formatDate(date, "Asia/Tokyo", "yyyy/MM/dd HH:mm"));
  // 2026/07/18 01:00

  // スクリプトの設定タイムゾーンを確認したいとき
  Logger.log(Session.getScriptTimeZone()); // 例: Asia/Tokyo
}

function formatDateColumn() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("予定");
  const lastRow = sheet.getLastRow();
  if (lastRow < 2) return;

  // A列に入っている日付を一括取得（ヘッダー除く）
  const dates = sheet.getRange(2, 1, lastRow - 1, 1).getValues();
  const tz = "Asia/Tokyo";

  const formatted = dates.map(([value]) => {
    // 空セルや文字列はそのまま返す
    if (!(value instanceof Date)) return [value];
    return [Utilities.formatDate(value, tz, "yyyy/MM/dd（EEE）")];
  });

  // B列にまとめて書き戻す
  sheet.getRange(2, 2, formatted.length, 1).setValues(formatted);
}

function backupWithDatedName() {
  const source = SpreadsheetApp.getActive();
  const stamp = Utilities.formatDate(new Date(), "Asia/Tokyo", "yyyyMMdd_HHmmss");
  const name = source.getName() + "_backup_" + stamp;

  // 例: 売上管理_backup_20260718_093000
  DriveApp.getFileById(source.getId()).makeCopy(name);
  Logger.log("バックアップ作成: " + name);
}