GASで見えるままの値を取得！getDisplayValue()でフォーマットを維持する方法

function checkValueDifference() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const dateCell = sheet.getRange('A1');

  // getValue() は Dateオブジェクトを返す
  const rawValue = dateCell.getValue();
  console.log(rawValue); // 例: Tue Dec 25 2025 00:00:00 GMT+0900 (Japan Standard Time)
  console.log(typeof rawValue); // 'object'

  // getDisplayValue() は見えている通りの文字列を返す
  const displayValue = dateCell.getDisplayValue();
  console.log(displayValue); // "2025/12/25"
  console.log(typeof displayValue); // 'string'
}

function getSingleDisplayValue() {
  const sheet = SpreadsheetApp.getActiveSheet();
  // B2セルの表示値を取得
  const displayValue = sheet.getRange('B2').getDisplayValue();
  console.log(`B2セルの表示は「${displayValue}」です。`); 
}

function getMultipleDisplayValues() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getRange('A1:B3');
  // 範囲内の表示値を二次元配列で取得
  const displayValues = range.getDisplayValues();
  
  console.log(displayValues);
  /*
    実行結果の例:
    [
      ["商品名", "価格"],
      ["リンゴ", "¥150"],
      ["バナナ", "¥200"]
    ]
  */
}

function sendReportMail() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const date = sheet.getRange('A1').getDisplayValue(); // "2025年12月25日"
  const totalSales = sheet.getRange('B1').getDisplayValue(); // "¥1,234,567"
  
  const subject = `${date} の売上報告`;
  const body = `本日の総売上は ${totalSales} でした。`;
  
  // GmailApp.sendEmail(..., subject, body);
  console.log(body); // 本日の総売上は ¥1,234,567 でした。
}

function postFormattedData() {
  const range = SpreadsheetApp.getActiveSheet().getRange('A1:C10');
  const displayData = range.getDisplayValues(); // 整形済みのデータを取得
  
  const payload = JSON.stringify({ data: displayData });
  
  UrlFetchApp.fetch('https://api.example.com/data', {
    method: 'post',
    contentType: 'application/json',
    payload: payload
  });
}

const priceCell = SpreadsheetApp.getActiveSheet().getRange('C1'); // 表示は "1,000"
const price = priceCell.getDisplayValue(); // "1,000" という文字列

// console.log(price * 1.1); // これは正しく計算できない！