在项目进度管理中，天视图是最常用的时间维度之一——它能够精确展示任务在每一天的起止位置，甚至细化到小时和分钟。vxe-gantt 提供了强大的天视图（day view） 渲染能力，支持 默认模式 和 精确模式 两种粒度，满足从日常任务跟踪到精细化排期的各种需求。

说明

vxe-gantt 通过 taskViewConfig.scales 配置项控制时间轴的层级结构。天视图通常配置为 [‘month’, ‘date’]，即时间轴分为“月”和“日”两级刻度，每个单元格代表一天。

适用场景：短期项目（数天至数月）、任务排期、日常工作计划、敏捷迭代跟踪等。

默认模式

在默认模式下，甘特图将日期解析到 天（yyyy-MM-dd），每个单元格对应一天。甘特条以天为单位在时间轴上定位，不区分具体的时间点（如小时、分钟）。

<template>
  <div>
    <vxe-gantt v-bind="ganttOptions"></vxe-gantt>
  </div>
</template>

<script setup>
import { reactive } from 'vue'

const ganttOptions = reactive({
  border: true,
  showOverflow: true,
  cellConfig: {
    height: 80
  },
  taskBarConfig: {
    showProgress: true,
    showContent: true,
    barStyle: {
      round: true,
      bgColor: '#f56565',
      completedBgColor: '#65c16f'
    }
  },
  taskViewConfig: {
    scales: ['month', 'date'],
    tableStyle: {
      width: 320
    },
    viewStyle: {
      cellWidth: 120
    }
  },
  columns: [
    { type: 'seq', field: 'seq', width: 70 },
    { field: 'title', title: '任务名称' },
    { field: 'start', title: '开始时间', width: 100 },
    { field: 'end', title: '结束时间', width: 100 }
  ],
  data: [
    { id: 10001, title: 'A项目', start: '2024-03-01 08:00:00', end: '2024-03-04 12:30:00', progress: 3 },
    { id: 10002, title: '城市道路修理进度', start: '2024-03-03 09:30:00', end: '2024-03-08 14:00:00', progress: 10 },
    { id: 10003, title: 'B大工程', start: '2024-03-03 06:30:20', end: '2024-03-11 09:30:40', progress: 90 },
    { id: 10004, title: '超级大工程', start: '2024-03-05 12:30:00', end: '2024-03-11 18:30:00', progress: 15 }
  ]
})
</script>

精确模式：精确到时分秒

通过设置 taskConfig.dateFormat，可以指定日期解析的精度（如 yyyy-MM-dd HH:mm:ss），让甘特条在单元格内精确反映任务的起止时刻。即使是天视图，也能在单日内展示任务在不同时段的分布。

注意：精确模式下，任务的 start 和 end 字段必须与 dateFormat 格式完全一致。

<template>
  <div>
    <vxe-gantt v-bind="ganttOptions"></vxe-gantt>
  </div>
</template>

<script setup>
import { reactive } from 'vue'

const ganttOptions = reactive({
  border: true,
  showOverflow: true,
  cellConfig: {
    height: 80
  },
  taskConfig: {
    dateFormat: 'yyyy-MM-dd HH:mm:ss'
  },
  taskBarConfig: {
    showProgress: true,
    showContent: true,
    barStyle: {
      round: true,
      bgColor: '#f56565',
      completedBgColor: '#65c16f'
    }
  },
  taskViewConfig: {
    scales: ['month', 'date'],
    tableStyle: {
      width: 320
    },
    viewStyle: {
      cellWidth: 120
    }
  },
  columns: [
    { type: 'seq', field: 'seq', width: 70 },
    { field: 'title', title: '任务名称' },
    { field: 'start', title: '开始时间', width: 160 },
    { field: 'end', title: '结束时间', width: 160 }
  ],
  data: [
    { id: 10001, title: 'A项目', start: '2024-03-01 08:00:00', end: '2024-03-04 12:30:00', progress: 3 },
    { id: 10002, title: '城市道路修理进度', start: '2024-03-03 09:30:00', end: '2024-03-08 14:00:00', progress: 10 },
    { id: 10003, title: 'B大工程', start: '2024-03-03 06:30:20', end: '2024-03-11 09:30:40', progress: 90 },
    { id: 10004, title: '超级大工程', start: '2024-03-05 12:30:00', end: '2024-03-11 18:30:00', progress: 15 }
  ]
})
</script>

两种模式对比

• vxe-gantt 的天视图提供了两种使用模式：
  • 默认模式：以天为粒度，简单直观，适合日常任务跟踪和计划展示。
  • 精确模式：通过 taskConfig.dateFormat 指定时间精度，在单元格内精确定位任务的起止时刻，适合需要细粒度时间管理的场景。

https://gantt.vxeui.com