使用node mssql向SQL Server插入Datetime时时间少1小时的问题

这问题我之前帮好几个开发者排查过，大概率是时区转换在搞鬼！JavaScript的Date对象自带时区信息，而SQL Server的datetime类型本身不带时区属性，两者交互时很容易因为时区不匹配出现时间偏差。下面是一步步的排查和解决方法：

1. 先确认时区差异 #

首先得搞清楚三方的时区情况：

• 你的Node.js运行环境本地时区：可以用console.log(new Date().getTimezoneOffset())查看，返回值是本地时间与UTC的分钟差（比如UTC+8会返回-480）
• SQL Server所在服务器的系统时区：执行SQL查询SELECT SYSDATETIMEOFFSET();，结果里的偏移量就是服务器时区与UTC的差值
• 你传入的date参数：如果是不带时区的字符串，JavaScript会默认用本地时区解析它

2. 针对性解决方案 #

方案一：强制使用UTC时间插入 #

把JavaScript的Date转成UTC时间后再插入，彻底避免本地时区的干扰：

async function insertDate(date, logIO) {
  try {
    // 将输入日期转换为UTC时间
    const d = new Date(date);
    const utcDate = new Date(Date.UTC(
      d.getFullYear(), 
      d.getMonth(), 
      d.getDate(), 
      d.getHours(), 
      d.getMinutes(), 
      d.getSeconds()
    ));
    
    const name = 'zdzmar';
    const pool = await sql.connect(config);
    let result = await pool.request()
      .input('date', TYPES.DateTime, utcDate)
      .input('name', TYPES.VarChar, name)
      .input('logIO', TYPES.TinyInt, logIO)
      .query(`INSERT INTO clock (date, name, logIO) VALUES (@date, @name, @logIO)`);
  } catch(err) {
    console.error('插入失败:', err);
  }
}

方案二：配置mssql连接的时区 #

在数据库连接配置里指定统一时区，让mssql模块按这个时区处理时间转换：

// 修改你的config配置，添加时区选项
const config = {
  user: 'your_username',
  password: 'your_password',
  server: 'your_server',
  database: 'your_database',
  options: {
    timezone: 'utc' // 也可以指定具体时区，比如 'Asia/Shanghai'
  }
};

// 原插入函数无需大幅修改
async function insertDate(date, logIO) {
  try {
    var d = new Date(date)
    var name = 'zdzmar'
    const pool = await sql.connect(config)
    let result = await pool.request()
      .input('date', TYPES.DateTime, d)
      .input('name', TYPES.VarChar, name)
      .input('logIO', TYPES.TinyInt, logIO)
      .query(`INSERT INTO clock (date, name, logIO) VALUES (@date, @name, @logIO)`);
  } catch(err) {
    // 错误处理逻辑
  }
}

方案三：改用DateTimeOffset类型（推荐） #

SQL Server的datetime类型比较老旧，建议改用datetimeoffset（带时区信息），配合mssql的TYPES.DateTimeOffset类型，彻底规避时区转换问题：

1. 先把数据库表的date字段类型修改为datetimeoffset(7)
2. 修改插入代码的input类型：

async function insertDate(date, logIO) {
  try {
    var d = new Date(date)
    var name = 'zdzmar'
    const pool = await sql.connect(config)
    let result = await pool.request()
      .input('date', TYPES.DateTimeOffset, d) // 替换为DateTimeOffset类型
      .input('name', TYPES.VarChar, name)
      .input('logIO', TYPES.TinyInt, logIO)
      .query(`INSERT INTO clock (date, name, logIO) VALUES (@date, @name, @logIO)`);
  } catch(err) {
    // 错误处理逻辑
  }
}

3. 验证方法 #

插入前先打印日期的详细信息，确认转换过程：

console.log('原始输入:', date);
console.log('JS Date对象:', d);
console.log('ISO格式（带时区）:', d.toISOString());
console.log('本地时区偏移:', d.getTimezoneOffset());

然后在SQL Server里查询插入的数据，对比UTC时间：

SELECT date, SWITCHOFFSET(date, '+00:00') AS utc_date FROM clock;

这样就能明确是哪一步的时区转换出了问题。

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