C#向Google BigQuery导数据：DateTime转Date格式报错解决方案

这个问题我之前帮不少开发者解决过——核心就是BigQuery的DATE类型只接受纯日期格式（yyyy-MM-dd），而C#的DateTime默认序列化会带时间部分，导致BigQuery识别失败。这里有几个靠谱的解决办法，按推荐程度排序：

1. 使用官方库的BigQueryDate类型（最推荐） #

Google.Cloud.BigQuery.V2库专门提供了对应BigQuery各类型的包装类，BigQueryDate就是用来匹配BigQuery的DATE类型的。你可以直接把DateTime转成这个类型，或者直接构造：

using Google.Cloud.BigQuery.V2;
using System;

// 初始化BigQuery客户端
var bigQueryClient = BigQueryClient.Create("your-project-id");
var targetTable = bigQueryClient.GetTable("your-dataset-id", "your-table-id");

// 示例DateTime值
DateTime originalDateTime = new DateTime(2017, 1, 2, 10, 30, 0);

// 转换为BigQueryDate
BigQueryDate bigQueryDate = BigQueryDate.FromDateTime(originalDateTime);

// 构造行数据
var row = new BigQueryRow
{
    ["ForDate"] = bigQueryDate,
    // 其他字段...
};

// 插入行
bigQueryClient.InsertRow(targetTable, row);

这个方法类型最安全，完全不会有格式问题，官方库会帮你处理序列化逻辑。

2. 用.NET 6+的DateOnly类型（简洁优雅） #

如果你用的是.NET 6或更高版本，C#新增了DateOnly类型，专门表示日期（不带时间），BigQuery的官方库已经支持直接映射这个类型：

// 从DateTime转成DateOnly
DateOnly dateOnly = DateOnly.FromDateTime(originalDateTime);

// 直接赋值给行数据
row["ForDate"] = dateOnly;

这种方式代码更简洁，语义也更清晰，不需要额外的包装类。

3. 手动格式化为纯日期字符串（兼容旧.NET版本） #

如果你的项目还在用.NET Framework或者低于6的.NET Core，可以手动把DateTime格式化为yyyy-MM-dd的字符串，注意要用不变文化避免格式差异：

using System.Globalization;

// 格式化为纯日期字符串
string dateString = originalDateTime.ToString("yyyy-MM-dd", CultureInfo.InvariantCulture);

row["ForDate"] = dateString;

这个方法要注意必须严格遵循yyyy-MM-dd的格式，不能有任何时间部分，否则还是会报错。

4. 实体类映射时指定类型（如果用实体类批量插入） #

如果你是用实体类批量上传数据，可以在ForDate属性上加上BigQueryProperty特性，指定对应BigQuery的DATE类型：

using Google.Cloud.BigQuery.V2;

public class YourDataModel
{
    // 指定该属性对应BigQuery的DATE类型
    [BigQueryProperty(Type = BigQueryDbType.Date)]
    public DateTime ForDate { get; set; }

    // 其他属性...
}

当你用InsertRows方法批量插入时，库会自动帮你把DateTime转换为正确的DATE格式，忽略时间部分。

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