Laravel Google Sheets部分场景自动添加单引号问题求助

1. 确保数据为原生数值/日期类型 #

Google Sheets的RAW模式会严格按传入的数据类型写入，若$data里的日期是字符串格式（比如'2024-05-20'）、整数是字符串类型的数字（比如'123'），即便格式正确，也会被识别为文本并自动添加单引号。

• 整数处理：强制转为原生数字类型

  $data = array_map(function ($row) {
      foreach ($row as $key => $value) {
          if (is_string($value) && is_numeric($value)) {
              $row[$key] = strpos($value, '.') !== false ? (float)$value : (int)$value;
          }
      }
      return $row;
  }, $data);
  

• 日期处理：转为Google Sheets可识别的日期序列号
  Google Sheets的日期本质是数值（以1900年1月1日为基准的天数），直接传入DateTime/Carbon实例可能无法被正确解析，需转换为对应数值：

  use Carbon\Carbon;
  
  $data = array_map(function ($row) {
      foreach ($row as $key => $value) {
          if ($value instanceof Carbon || $value instanceof DateTime) {
              $row[$key] = $value->getTimestamp() / 86400 + 25569;
          }
      }
      return $row;
  }, $data);
  

  转换后写入的日期会自动适配单元格日期格式，不会带单引号。

2. 切换valueInputOption为USER_ENTERED #

若RAW模式不符合预期，改用USER_ENTERED模式（模拟手动输入行为，Google Sheets会自动识别数据类型）：

$params = [
    'valueInputOption' => 'USER_ENTERED'
];

这种模式下，符合日期/数字格式的字符串会被自动识别为对应类型，无需手动转换数值。

3. 改用Laravel Sheets包的封装调用 #

你当前直接实例化Google_Service_Sheets，可尝试使用包的封装方法，避免手动处理客户端实例可能出现的参数传递问题：

use Maatwebsite\Excel\Facades\Sheets;

Sheets::spreadsheet($spreadsheetId)
    ->sheet($sheetName)
    ->append($data, [
        'valueInputOption' => 'USER_ENTERED' // 或'RAW'
    ]);

4. 排查目标单元格格式 #

若上述方法无效，检查目标工作表的单元格格式：

• 选中对应列，设置格式为「日期」或「数字」（而非「文本」）
• 即便传入正确数值类型，若单元格默认是文本格式，也可能被强制转为文本显示（带单引号）

内容的提问来源于stack exchange，提问作者Bojan