用 fputcsv 写入带日期时间格式的字段时，怎样格式化才能正确保存？

M66 2025-08-05

一、问题的产生

fputcsv 函数将数据以逗号分隔的形式输出到文件中。由于 CSV 文件本质上是一个纯文本格式，所有字段都以字符串的形式保存。因此，如果我们直接将 PHP 的 DateTime 对象或者包含日期时间的字段写入 CSV 文件，可能会遇到以下问题：

格式不一致：不同系统或程序读取 CSV 文件时，可能无法正确识别日期时间字段的格式。
数据丢失或错误：某些日期时间格式可能在保存时会丢失精度，尤其是包含时区信息的日期。

为了避免这些问题，必须在写入前对日期时间字段进行合理的格式化。

二、日期时间格式化的关键

在使用 fputcsv 写入包含日期时间的字段时，最常用的做法是使用 DateTime 对象的 format 方法，将日期时间转化为一致的字符串格式。例如，ISO 8601 格式（Y-m-d H:i:s）通常是一个通用且兼容性强的选择。

1. 使用 DateTime 对象格式化日期时间

假设我们有一个 DateTime 对象，想要将它写入 CSV 文件，可以使用如下代码：

<span><span><span class="hljs-variable">$date</span></span><span> = </span><span><span class="hljs-keyword">new</span></span><span> </span><span><span class="hljs-title class_">DateTime</span></span><span>();
</span><span><span class="hljs-variable">$formattedDate</span></span><span> = </span><span><span class="hljs-variable">$date</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">format</span></span><span>(</span><span><span class="hljs-string">'Y-m-d H:i:s'</span></span><span>);  </span><span><span class="hljs-comment">// 格式化为 '2025-07-27 14:45:00'</span></span><span>
</span></span>

这会将当前日期时间格式化为 YYYY-MM-DD HH:MM:SS 的字符串。

2. 手动格式化字符串

如果日期时间字段是字符串类型（如从数据库中获取），我们同样可以使用 DateTime::createFromFormat 方法来转换并格式化日期。例如：

<span><span><span class="hljs-variable">$dateString</span></span><span> = </span><span><span class="hljs-string">'2025-07-27 14:45:00'</span></span><span>;
</span><span><span class="hljs-variable">$date</span></span><span> = </span><span><span class="hljs-title class_">DateTime</span></span><span>::</span><span><span class="hljs-title function_ invoke__">createFromFormat</span></span><span>(</span><span><span class="hljs-string">'Y-m-d H:i:s'</span></span><span>, </span><span><span class="hljs-variable">$dateString</span></span><span>);
</span><span><span class="hljs-variable">$formattedDate</span></span><span> = </span><span><span class="hljs-variable">$date</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">format</span></span><span>(</span><span><span class="hljs-string">'Y-m-d H:i:s'</span></span><span>);
</span></span>

三、使用 fputcsv 写入 CSV 文件

接下来，我们来看如何在使用 fputcsv 时，将格式化后的日期时间写入 CSV 文件。假设我们有一个包含多个字段的数组，其中一个字段是日期时间字段。

<span><span><span class="hljs-variable">$data</span></span><span> = [
    [</span><span><span class="hljs-string">'Name'</span></span><span>, </span><span><span class="hljs-string">'Date'</span></span><span>, </span><span><span class="hljs-string">'Amount'</span></span><span>],
    [</span><span><span class="hljs-string">'John Doe'</span></span><span>, </span><span><span class="hljs-string">'2025-07-27 14:45:00'</span></span><span>, </span><span><span class="hljs-number">1000</span></span><span>],
    [</span><span><span class="hljs-string">'Jane Smith'</span></span><span>, </span><span><span class="hljs-string">'2025-07-28 09:30:00'</span></span><span>, </span><span><span class="hljs-number">1500</span></span><span>]
];

</span><span><span class="hljs-variable">$file</span></span><span> = </span><span><span class="hljs-title function_ invoke__">fopen</span></span><span>(</span><span><span class="hljs-string">'data.csv'</span></span><span>, </span><span><span class="hljs-string">'w'</span></span><span>);

</span><span><span class="hljs-comment">// 写入标题行</span></span><span>
</span><span><span class="hljs-title function_ invoke__">fputcsv</span></span><span>(</span><span><span class="hljs-variable">$file</span></span><span>, </span><span><span class="hljs-variable">$data</span></span><span>[</span><span><span class="hljs-number">0</span></span><span>]);

</span><span><span class="hljs-comment">// 写入数据行，并确保日期格式化正确</span></span><span>
</span><span><span class="hljs-keyword">foreach</span></span><span> (</span><span><span class="hljs-variable">$data</span></span><span> </span><span><span class="hljs-keyword">as</span></span><span> </span><span><span class="hljs-variable">$row</span></span><span>) {
    </span><span><span class="hljs-variable">$row</span></span><span>[</span><span><span class="hljs-number">1</span></span><span>] = (</span><span><span class="hljs-keyword">new</span></span><span> </span><span><span class="hljs-title class_">DateTime</span></span><span>(</span><span><span class="hljs-variable">$row</span></span><span>[</span><span><span class="hljs-number">1</span></span><span>]))-&gt;</span><span><span class="hljs-title function_ invoke__">format</span></span><span>(</span><span><span class="hljs-string">'Y-m-d H:i:s'</span></span><span>);  </span><span><span class="hljs-comment">// 格式化日期字段</span></span><span>
    </span><span><span class="hljs-title function_ invoke__">fputcsv</span></span><span>(</span><span><span class="hljs-variable">$file</span></span><span>, </span><span><span class="hljs-variable">$row</span></span><span>);
}

</span><span><span class="hljs-title function_ invoke__">fclose</span></span><span>(</span><span><span class="hljs-variable">$file</span></span><span>);
</span></span>

在这个例子中，第二列（Date）是一个日期时间字段。在写入文件之前，我们使用 DateTime 对象的 format 方法将日期格式化为 Y-m-d H:i:s 形式。这样，无论在哪个系统中读取 CSV 文件，日期都会保持一致的格式，减少了格式不一致的问题。

四、注意事项

时区问题：如果你的日期时间包含时区信息，建议使用 ISO 8601 格式（Y-m-d\TH:i:sP），其中 P 会输出时区信息。例如：2025-07-27T14:45:00+00:00。确保在格式化时正确处理时区，避免时区转换带来的问题。
CSV 文件的编码：确保保存 CSV 文件时使用正确的编码格式。推荐使用 UTF-8 编码，以确保特殊字符（如中文）能被正确保存。
日期时间的有效性检查：在格式化之前，最好验证日期时间字符串的有效性，避免无效的日期（例如，2025-02-30）导致格式化错误。

fputcsv
date