使用\COPY导入含毫秒时间戳的CSV时报错：日期时间值超出范围

这个错误的核心原因是：CSV里的1679356641166是毫秒级Unix时间戳（数字），但PostgreSQL的timestamptz类型无法直接识别这种数字格式——它会把数字当成日期字符串解析（比如尝试匹配YYYYMMDDHHMMSS格式），而这个数字远超出合法日期范围，因此报错。DateStyle设置不影响这个问题，因为根本不是日期字符串格式的问题。

下面是三种可行的解决方法：

方法一：临时中转表（最稳妥） #

1. 创建临时表，将时间戳列设为bigint类型：

CREATE TEMP TABLE temp_call_stats (
  -- 复制目标表的列结构，仅把timestamp_milli改为bigint
  id INT,
  timestamp_milli BIGINT,
  -- 其他列...
);

2. 用\COPY导入临时表：

\COPY temp_call_stats FROM 'your_file.csv' WITH (FORMAT csv, HEADER);

3. 将数据转换后插入目标hypertables：

INSERT INTO call_stats (id, timestamp_milli, /* 其他列 */)
SELECT 
  id,
  to_timestamp(timestamp_milli / 1000)::timestamptz,
  /* 其他列直接复制 */
FROM temp_call_stats;

to_timestamp()函数接收秒级Unix时间戳，所以把毫秒数除以1000得到秒级，再转换为timestamptz。

方法二：使用PROGRAM选项实时转换（无需临时表） #

利用PostgreSQL的PROGRAM选项，通过awk脚本在导入时把毫秒时间戳转成PostgreSQL能识别的日期字符串。假设时间戳在CSV的第2列：

\COPY call_stats FROM PROGRAM 'awk -F '\'''\'' '\''BEGIN {OFS=","} { $2 = strftime("%Y-%m-%d %H:%M:%S", substr($2,1,10)) "." substr($2,11); print }'\'' your_file.csv' WITH (FORMAT csv, HEADER);

• substr($2,1,10)提取前10位（秒级时间戳），用strftime转成日期时间字符串
• substr($2,11)提取后3位（毫秒部分），拼接到字符串末尾

方法三：修改CSV文件（适合小文件） #

如果文件不大，可以提前用脚本把毫秒时间戳批量转成YYYY-MM-DD HH:MM:SS.FFF格式的字符串，再直接用\COPY导入。比如用Python脚本处理：

import csv
from datetime import datetime

with open('input.csv', 'r') as infile, open('output.csv', 'w', newline='') as outfile:
    reader = csv.DictReader(infile)
    writer = csv.DictWriter(outfile, fieldnames=reader.fieldnames)
    writer.writeheader()
    for row in reader:
        ms = int(row['timestamp_milli'])
        dt = datetime.fromtimestamp(ms / 1000, datetime.timezone.utc)
        row['timestamp_milli'] = dt.isoformat()
        writer.writerow(row)

处理完成后，直接导入output.csv即可。

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