DateTimeAxis QML Type
将 DateTime 项目添加到图的坐标轴上。更多...
| Import Statement: | import QtGraphs |
| In C++: | QDateTimeAxis |
| Inherits: |
- 所有成员列表（包括继承的成员）
- DateTimeAxis 是“Qt Graphs ”2D QML 类型的一部分。
属性
- labelFormat : string
- max : real
- min : real
- pan : real
(since 6.11) - subTickCount : int
- tickCount : real
(since 6.12) - tickInterval : real
(until 6.15) - timeZone : QTimeZone
(since 6.11) - visualMax : real
(since 6.11) - visualMin : real
(since 6.11) - zoom : real
(since 6.11)
信号
- labelFormatChanged(string format)
- maxChanged(DateTime max)
- minChanged(DateTime min)
- rangeChanged(real min, real max)
- subTickCountChanged(int subTickCount)
- tickCountChanged(real count)
(since 6.12) - tickIntervalChanged(real tickInterval)
(until 6.15) - timeZoneChanged()
(since 6.11) - zoomChanged()
(since 6.11)
方法
- string timeZoneAsString()
(since 6.11) - QTimeZone timeZoneFromString(string zoneId)
(since 6.11)
详细说明
DateTime 坐标轴可用于通过刻度线和网格线显示 DateTime 表示形式。坐标轴上的 DateTime 项目将显示在刻度位置处。
以下示例代码演示了如何使用 DateTimeAxis 类型：
GraphsView {
axisX: DateTimeAxis {
min: new Date(2000,1,1)
max: new Date(1970,1,1)
}
LineSeries {
// Add a few XYPoint data...
}
}属性文档
labelFormat : string
坐标轴上 DateTime 标签的格式。通过 format 属性可以指定 DateTime 对象在天、月和年层面的视觉显示形式。默认值为 dd-MMMM-yy。
max : real
轴上的最大值。
该值可以小于或大于最小值。DateTime 类型在内部以 UTC 格式存储。默认值为 new Date(1980,1,1)
min : real
轴上的最小值。
该值可以小于或大于最大值。DateTime 类型在内部以 UTC 格式存储。默认值为 new Date(1970,1,1)
pan : real [since 6.11]
该轴的平移值。
平移值用于移动坐标轴的中心点，同时不会影响网格和标签的间隔。默认值为 0。
该属性自 Qt 6.11 起引入。
subTickCount : int
轴上的子刻度数量。这表示图表中主刻度线之间会绘制多少个子刻度。子刻度不显示标签。默认值为 0。
tickCount : real [since 6.12]
轴上主要刻度的数量。如果该值为 0 或更小，轴将自动计算适当的刻度数量。默认值为 0。
该属性自 Qt 6.12 起引入。
tickInterval : real [until 6.15]
该属性计划在 6.15 版本中被废弃。
轴上放置的主要刻度数量。如果该值为 0 或更小，轴将自动计算适当的刻度数量。默认值为 0。请改用 `tickCount `。
timeZone : QTimeZone [since 6.11]
用于显示坐标轴标签的时区。支持的值基于 IANA 时区标识符。默认时区为 UTC。
该属性自 Qt 6.11 起引入。
visualMax : real [read-only, since 6.11]
坐标轴的视觉最大值。
当轴被平移或缩放时，此属性保存轴的视觉最大值。默认值为max
该属性于 Qt 6.11 中引入。
visualMin : real [read-only, since 6.11]
轴的视觉最小值。
当轴被平移或缩放时，该属性将保存轴的视觉最小值。默认值为min
该属性自 Qt 6.11 起引入。
zoom : real [since 6.11]
坐标轴的缩放值。该缩放值可放大或缩小坐标轴，从而放大或缩小图表，同时不会影响网格间距和刻度标签。默认值为 1。
该属性自 Qt 6.11 起引入。
信号文档
labelFormatChanged(string format)
当坐标轴标签的format 发生变化时，会触发此信号。
注意： 对应的处理程序 为onLabelFormatChanged 。
maxChanged(DateTime max)
当由max 指定的轴的最大值发生变化时，会触发此信号。
注意： 相应的处理程序 是onMaxChanged 。
minChanged(DateTime min)
当由min 指定的坐标轴最小值发生变化时，会触发此信号。
注意： 相应的处理程序 为onMinChanged 。
rangeChanged(real min, real max)
当由min 和max 指定的轴的最小值或最大值发生变化时，会触发此信号。
注意： 相应的处理程序 是onRangeChanged 。
subTickCountChanged(int subTickCount)
当轴上的子刻度数量（由subTickCount 指定）发生变化时，会发出此信号。
注意： 相应的处理程序 为onSubTickCountChanged 。
[since 6.12] tickCountChanged(real count)
当由count 指定的轴的tickCount 发生变化时，会发出此信号。
注意： 对应的处理程序 为onTickCountChanged 。
该信号在 Qt 6.12 中引入。
[until 6.15] tickIntervalChanged(real tickInterval)
该信号计划在 6.15 版本中被废弃。
当由 `tickInterval` 指定的 tick 间隔值发生变化时，会发出此信号。请改用 `tickCountChanged `。
注意： 相应的处理程序 为onTickIntervalChanged 。
[since 6.11] timeZoneChanged()
当时区发生变更时，会触发此信号。它表示所设置的 IANA 时区 ID 的字符串值。
注意： 对应的处理程序 是onTimeZoneChanged 。
该信号在 Qt 6.11 中引入。
[since 6.11] zoomChanged()
当缩放值发生变化时，会触发此信号。
注意： 相应的处理函数 为onZoomChanged 。
该信号在 Qt 6.11 中引入。
方法文档
[since 6.11] string timeZoneAsString()
返回QDateTimeAxis::timeZone 的基于IANA的区域标识符，格式为字符串。
该方法在 Qt 6.11 中引入。
另请参阅 timeZone 。
[since 6.11] QTimeZone timeZoneFromString(string zoneId)
返回与基于 IANA 的zoneId 对应的QTimeZone 。
注意：这是 用于设置timeZone 的转换方法。
该方法于 Qt 6.11 中引入。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
