使用@google-cloud/bigquery时，如何让DateTime字段直接返回字符串值？

使用@google-cloud/bigquery npm包执行BigQuery查询时，所有DateTime类型的列都会被返回为带value属性的嵌套对象，示例如下：

{
    "id": "B4BCEEB7-BB95-4163-8B22-C81588682AEC",
    "aString": "37SBAUL4464",
    "effectiveDate": {
        "value": "1970-01-01T00:00:00"
    }
}

这种格式处理起来十分繁琐，希望能让DateTime属性直接返回对应字符串值，不再额外嵌套对象，期望格式如下：

{
    "id": "B4BCEEB7-BB95-4163-8B22-C81588682AEC",
    "aString": "37SBAUL4464",
    "effectiveDate": "1970-01-01T00:00:00"
}

相关代码片段：

import {BigQuery} from '@google-cloud/bigquery'; // 文件顶部导入

const bigQueryClient = new BigQuery();
const query = `
    select
        p.PolicyID as id,
        p.SomeString as aString,
        p.EffectiveDate as effectiveDate
    from
        \`my-dataset-11111.2222222222__001.Policy\` as p
`;

const options = {
    query: query,
    location: config.bigQueryLocation,
};

const [rows] = await bigQueryClient.query(options);

方法1：通过查询配置直接返回字符串（推荐） #

在查询选项中添加formatOptions配置，指定日期时间的返回格式为ISO字符串；或者开启useBigQueryJson，让结果和BigQuery JSON API输出格式对齐，两种方式都能让DateTime直接返回字符串：

// 方式1：指定datetime格式
const options = {
    query: query,
    location: config.bigQueryLocation,
    formatOptions: {
        datetimeFormat: 'iso' // 强制返回ISO标准格式的字符串
    }
};

// 方式2：对齐BigQuery JSON API格式
const options = {
    query: query,
    location: config.bigQueryLocation,
    useBigQueryJson: true
};

方法2：手动遍历转换结果 #

如果无法修改查询配置，可在拿到原始结果后遍历处理，提取嵌套对象的value属性：

const [rawRows] = await bigQueryClient.query(options);
const rows = rawRows.map(row => {
    const processedRow = {...row};
    for (const key in processedRow) {
        const val = processedRow[key];
        // 识别带value属性的日期时间对象并转换
        if (typeof val === 'object' && val !== null && 'value' in val) {
            processedRow[key] = val.value;
        }
    }
    return processedRow;
});

这种方法适合兼容旧版本库或需要自定义字段处理逻辑的场景。

方法3：在SQL层面直接转换 #

在查询语句中用FORMAT_TIMESTAMP函数将DateTime类型转成目标格式的字符串，查询结果直接返回字符串值：

select
    p.PolicyID as id,
    p.SomeString as aString,
    FORMAT_TIMESTAMP('%Y-%m-%dT%H:%M:%E6S', p.EffectiveDate) as effectiveDate
from
    `my-dataset-11111.2222222222__001.Policy` as p

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