PDFiumPas 文档

CreationDate 属性

此 API 条目保留标识符、签名、代码块和 PDF 术语的原始形式。
组件: TPdf  ·  单元: PDFium
文档 Info 字典中的原始创建时间戳。

语法

property CreationDate: WString; // 只读

说明

CreationDate 会将文档 Information 字典中的 /CreationDate 条目(PDF 1.7 规范 §14.3.3)作为原始 PDF 日期字面量返回。其值的格式为 D:YYYYMMDDHHmmSSOHH'mm' —— 例如,D:20231201090000Z 表示 2023 年 12 月 1 日 UTC 09:00,D:20260514103015+08'00' 表示 UTC+08:00 的 10:30:15(PDF 1.7 规范 §7.9.4)。

ActiveFalse、文档未声明 Info 字典,或者未写入 /CreationDate 条目时,该字符串为空。大多数创作工具会在 PDF 首次生成时记录这个时间戳,然后保持不变;ModifiedDate 则反映后续编辑。将 CreationDate 与 ModifiedDate 进行比较,是判断 PDF 自初次导出后是否被编辑过的快捷方法。

解析日期字符串时,需要去掉 D: 前缀,解码固定宽度字段,然后解释末尾的时区偏移量(撇号是字面语法的一部分)。PDFiumPas 暴露原始文本,以便调用者按自己的偏好进行转换:构造 TDateTime、按区域设置格式化,或者交给能处理不同截断形式的正则表达式 / 解析器。

备注

示例

var Created, Modified: WString;
Created := Pdf1.CreationDate;
Modified := Pdf1.ModifiedDate;
if (Created <> '') and (Created <> Modified) then
  Log.Add('Document edited since creation');

另请参阅

ModifiedDate, Author, Producer, MetaText