甘特图数据格式：列、日期和工期
QueryChart 甘特图会读取哪些列、识别哪些表头名称、接受哪些日期和工期格式，以及“依赖于”怎么写，附示例表格及其生成的结果。
由表格生成的甘特图，质量取决于表格。本指南列出 QueryChart 读取的列、它接受的列名，以及日期、工期和依赖关系的确切写法，让粘贴进来的表格如你所愿。
简而言之
- 只有“任务”列会创建任务；粘贴的行若没有任务名称，则不会被添加。
- 工期是整个工作日（周一至周五）；0 表示里程碑，小时会被拒绝。
- “依赖于”接受任务编号或名称，可带类型和延隔，例如 3、5SS+2 或 7FF-1。
- 日期写成 2026-10-20：它在任何语言中读法都相同，而 3/4/2026 则遵循你的 QueryChart 界面语言。
- 无法读取的单元格会单独被拒绝并给出消息，绝不会变成猜测。
甘特表读取什么
甘特表有十列：任务、开始、结束、工期、依赖于、进度、分组、人员、备注和链接（Task、Start、Finish、Duration、Depends on、Progress、Group、People、Notes、Link）。创建任务只需要“任务”这一列，其余都是可选的，而你通常留空的是“开始”：没有固定日期时，每项任务在它所依赖的事项允许时开始，日期由工期和链接算出。
粘贴第一行写有列名的表时，QueryChart 按名称匹配每一列，顺序不限，并且不会把表头行本身写进去。名称对大小写和标点很宽容，所以 Start date、start-date 和 START DATE 是同一个，而 % Complete 会被读作 complete。“任务”也可写作 Name、Activity、Title 或 Item。“开始”也可写作 Begin 或 From。“结束”也可写作 Finish、End、Due 或 To，带不带 date 均可。“工期”也可写作 Days 或 Length。“依赖于”也可写作 Predecessors、Dependencies 或 After。“进度”也可写作 Complete、Done 或 Status。“分组”也可写作 Phase、Section、Lane、Category、Stage 或 Workstream。“人员”也可写作 Owner、Assigned to、Assignee 或 Resource。“备注”也可写作 Note、Comments 或 Description，“链接”也可写作 URL。你的 QueryChart 界面语言中的名称同样可用。
第一行至少要识别出两列，否则这块内容会被当作普通数据，连同表头一起按位置落进表里。同名的列只保留第一个，表里不认识的列会被跳过并在消息中列出，所以不会有东西被悄悄丢掉。每个单元格各自检查：无法读取的值会被拒绝，并有消息指明列和任务编号，其余的粘贴内容照常写入。
下面这些规则值得了解，因为日期读反了会让整份计划移位。表格按你所用语言的顺序读取数字日期，所以保险起见请用年份在前的写法；完全无法读取的值会被拒绝。示例是项目甘特图模板，其“工期”和“依赖于”单元格展示了实际使用的格式。同一件事的流程视图，见流程图 /zh/templates/项目变更申请流程 和 /zh/templates/项目收尾流程；怎样把表格导入，见 /zh/guides/从excel或csv生成甘特图。
一张表，逐列读取
四个分组共十六项任务。工期仅为示意。打开电子表格面板，可以看到各阶段对应的“工期”和“依赖于”单元格。
任务、工期和默认的链接
“启动会议”的工期是 2，“明确范围与目标”是 4，“干系人签字确认”是 0，所以它是里程碑。它们的“依赖于”单元格分别是 1 和 2，因此每项任务都接在前一项之后。没有设置“开始”，所以没有固定任何日期。
一个单元格里有多个前置任务
“拆分工作任务”依赖于 3。“进度与预算”（4 天）和“风险与质量计划”（3）都依赖于 4，所以它们并排进行。里程碑“计划获批”的“依赖于”是 5, 6，它等这两者中较长的那一个。
类型和延隔
“交付第一阶段”持续 15 天，依赖于 7。“每周状态评审”持续 20 天，依赖于 8SS，即开始到开始的链接，所以它与第一阶段同时开始。“项目中期评审”是依赖于 8 的里程碑。
完整的表
“验收测试”的“依赖于”是 9, 12，所以它等“每周状态评审”和“质量检查”，由较晚的那个决定。“移交与培训”持续 4 天，随后“项目关闭”（0）和“经验教训”（2）都依赖于 14。
运作方式
每行一项任务，并加一行表头
在第一行写列名，其下每行一项任务。使用上面的名称。不要留空行、合并单元格，也不要把阶段标题单独占一行，因为每一个有名称的行都会成为一项任务。请把阶段放在“分组”列里。
用工作日写工期
用整数：5、5d 或 5 days。一周写成 1w 或 1 week，算一个工作周。允许 1w 2d，1.5w 会被取整为整天。0 或英文单词 milestone 表示里程碑。半天、2.5 以及 8h 这样的小时都会被拒绝，请先换算。
把日期写成年-月-日
无论你账户的语言是什么，2026-10-20 的读法都相同。月份名称也可以：20 Oct 2026、Oct 20, 2026 或 20 October。前面的星期会被忽略。没有年份的日期取最接近计划开始日的年份，两位数的年份表示 20xx。
了解数字日期如何读取
像 3/4/2026 这样的日期，按你的 QueryChart 界面语言的顺序读取：英语是月在前，丹麦语、德语、西班牙语和法语是日在前。它不会被标记，所以同一张表对两个人可能读出不同的结果。年份在前的写法，如 2026/4/3，永远是年-月-日。请优先使用 ISO 格式。
按编号或名称写“依赖于”
列出任务所等待的任务，用逗号分隔：3, 5。编号是任务在图中的行号，不是你复制来源文件里的行号。名称必须与某个任务的完整名称一致且唯一，含逗号的名称无法使用。在任务后可加类型（FS、SS、FF 或 SF）和以工作日计的延隔：5SS+2、7FF-1、4+1w。
在“开始”、“结束”和“工期”之间做选择
除非日期确实固定，否则让“开始”留空；与依赖关系冲突的固定开始日会被标出。“结束”是最后一个工作日，并据任务的开始日定出工期，所以请与“开始”一起粘贴，或改用“工期”。如果一行同时有“工期”和“结束”，以“结束”为准。
应避免的错误
只粘贴“结束”而不带“开始”
没有“开始”时，粘贴的“结束”是从读取该单元格时任务所处的位置算起的。依赖关系在日期之后才应用，所以任务还没有被它所等待的事项推后，工期会算得过长或过短。请改为粘贴“工期”，或把“开始”和“结束”一起粘贴。
数的是文件里的行，而不是任务
“依赖于”里的编号指图中的任务编号。来源里的表头行、空行或阶段行会使它们错位。如果你的表有这些，请在“依赖于”里用任务名称，或在粘贴之后检查编号。
相信状态列
名为 Status 的列会被读作进度，但只认 0 到 100 的数字（带不带 % 均可）或 done 一词。“进行中”和“未开始”会被拒绝。像 0.5 这样的小数进度同样被拒绝，请写 50。
指望日期列就是计划
甘特图中的日期是工期和链接的输出。如果你在每一行都粘贴了“开始”，每项任务就都被钉住，改动其中一项也不会带动其他任何任务。只钉住来自外部的固定日期。
打开项目甘特图
打开项目模板，看看“工期”和“依赖于”单元格，然后把你自己的表粘贴上去。
相关指南
常见问题
哪些列可以粘贴进 QueryChart 甘特图？
任务、开始、结束、工期、依赖于、进度、分组、人员、备注和链接（Task、Start、Finish、Duration、Depends on、Progress、Group、People、Notes、Link）。把名称写在第一行，只要至少识别出两个，QueryChart 就按任意顺序匹配。不认识的列会被跳过并列出。
接受哪些日期格式？
ISO（2026-10-20）、用斜线或点分隔的年份在前写法、按你的 QueryChart 界面语言顺序读取的数字日期，以及带日、可带年的月份名称。带时间的日期、Excel 序列号、季度和 next Friday 这样的说法会被拒绝。
可以用半天或小时吗？
不可以。甘特图以整个工作日（周一至周五）计数，没有节假日。小时会被拒绝，带小数的天数也会被拒绝。请向上取整到天，或把工作拆成整天的任务。
无法读取的单元格会怎样？
它会单独被拒绝，该单元格什么也不写入。粘贴的其余部分照常写入，并有一条消息指出列和任务编号，例如第 4 行的“开始”不是日期。请修正来源单元格后，重新粘贴那一列。
能把数据导出来吗？
能。甘特图可以导出为 CSV，包含任务、ISO 格式的日期、工期、依赖关系和进度，也可以导出为 PDF、PNG 和 SVG。导入的办法见 /zh/guides/从excel或csv生成甘特图。
