Google Community Connector日期时间字段在Looker Studio显示为Null问题求助

问题描述 #

我正在开发Looker Studio的Google Community Connector，从API获取的日期时间格式为"2023-02-22T19:26:44Z"。为获取完整日期时间，字段定义如下：

fields
  .newDimension()
  .setId('timestamp')
  .setName('Date')
  .setType(types.YEAR_MONTH_DAY_SECOND);

已知YEAR_MONTH_DAY_SECOND类型要求格式为YYYYMMDDHHmmss（例如20170317023017），因此编写了格式化函数：

function yyyymmddhhmmss(date) {
  var MM = date.getMonth() + 1; // getMonth()是从零开始计数
  var dd = date.getDate();
  var hh = date.getHours();
  var mm = date.getMinutes();
  var ss = date.getSeconds();

  return [date.getFullYear(),
          (MM>9 ? '' : '0') + MM,
          (dd>9 ? '' : '0') + dd,
          (hh>9 ? '' : '0') + hh,
          (mm>9 ? '' : '0') + mm,
          (ss>9 ? '' : '0') + ss
         ].join('');
};

调用前通过var date = new Date(value);将API返回值转为Date对象，再用上述函数格式化，但在Looker Studio中该字段作为筛选条件或图表数据时，仅显示Null值。

问题原因及解决方法 #

核心问题：时区处理错误 #

API返回的是UTC时区的时间（带Z后缀），new Date()解析后生成的Date对象会保留UTC信息，但你用的getMonth()、getDate()等方法是本地时区的取值方法，这会导致格式化后的时间字符串和原始UTC时间出现偏差，Looker Studio无法识别不符合要求的时间格式，因此显示Null。

修复方案：改用UTC时区的日期方法 #

将格式化函数中的本地时区方法替换为UTC对应的方法，确保生成的时间字符串严格匹配原始UTC时间：

function yyyymmddhhmmss(date) {
  var MM = date.getUTCMonth() + 1; // 替换为getUTCMonth()
  var dd = date.getUTCDate(); // 替换为getUTCDate()
  var hh = date.getUTCHours(); // 替换为getUTCHours()
  var mm = date.getUTCMinutes(); // 替换为getUTCMinutes()
  var ss = date.getUTCSeconds(); // 替换为getUTCSeconds()

  return [date.getUTCFullYear(), // 替换为getUTCFullYear()
          (MM>9 ? '' : '0') + MM,
          (dd>9 ? '' : '0') + dd,
          (hh>9 ? '' : '0') + hh,
          (mm>9 ? '' : '0') + mm,
          (ss>9 ? '' : '0') + ss
         ].join('');
};

额外验证步骤 #

• 确认API返回的时间字符串是标准ISO 8601格式，new Date()能正确解析
• 打印转换后的时间字符串，检查是否严格符合YYYYMMDDHHmmss格式，无位数缺失或多余字符
• 验证格式化后的字符串和原始UTC时间完全一致，无时区偏移

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