dateaxis

将序列-日期轴标签转换为日历-日期轴标签

全页折叠

语法

dateaxis(Tickaxis,DateForm,StartDate)

说明

dateaxis(Tickaxis,DateForm,StartDate) 用日期标签替换轴刻度标签。

示例

全部折叠

用日期标签替换轴刻度标签

打开实时脚本

此示例说明如何使用 dateaxis 将图形上的轴刻度标签替换为日期标签。

将 x 轴标签转换为自动确定的日期格式。

dateaxis('y', 6)

将 y 轴标签转换为月/日格式。

dateaxis('x', 2, datetime(1999,3,3))

将 x 轴标签转换为月/日/年格式。最低 x 刻度值被视为 1999 年 3 月 3 日。

dateaxis('x', 2, datetime(1999,3,3))

Figure contains an axes object. The axes object is empty.

输入参数

全部折叠

`Tickaxis` — 确定要替换的轴刻度标签 `x`、`y`、`z`
`'x'` (默认) | 值为 `'x'`、`'y'` 或 `'z'` 的特征向量

（可选）确定要替换哪个轴刻度标签，即 x、y 或 z，指定为字符向量。

数据类型: char

`DateForm` — 定义要使用的日期格式
基于轴范围的日期格式 (默认) | 从 `0` 到 `17` 的整数

（可选）定义要使用的日期格式，指定为从 0 到 17 的整数。

如果没有输入 DateForm 参量，则此函数根据轴范围的跨度确定日期格式。例如，如果轴的最小值和最大值之间的差小于 15，则刻度标签将转换为三个字母的星期几缩写 (DateForm = 8)。

`DateForm`	格式	描述
`0`	`01-Mar-1999 15:45:17`	日-月-年时:分:秒
`1`	`01-mar-1999`	日-月-年
`2`	`03/01/99`	月/日/年
`3`	`Mar`	月（三个字母）
`4`	`M`	月（单字母）
`5`	`3`	月
`6`	`03/01`	月/日
`7`	`1`	日期
`8`	`Wed`	星期几（三个字母）
`9`	`W`	星期几（单字母）
`10`	`1999`	年份（四位数）
`11`	`99`	年份（两位数）
`12`	`Mar99`	月年
`13`	`15:45:17`	时:分:秒
`14`	`03:45:17 PM`	时:分:秒（上午或下午）
`15`	`15:45`	时:分
`16`	`03:45 PM`	时:分（上午或下午）
`17`	`95/03/01`	年月日

有关修改轴刻度值和其他轴参数的信息，请参阅 MATLAB^® set 命令。

数据类型: double

`StartDate` — 将日期分配给第一个轴刻度值
轴下限转换为适当的日期数字 (默认) | 日期时间标量 | 字符串标量 | 日期字符向量

（可选）将日期分配给第一个轴刻度值，指定为标量日期时间、字符串或日期字符向量。

默认的 StartDate 是转换为适当日期数字的轴下限。例如，刻度值 1 转换为日期 01-Jan-0000。输入 StartDate 为 '06-apr-1999' 将日期 1999 年 4 月 6 日指定给第一个刻度值，并相应地设置轴刻度标签。

为了支持现有代码，dateaxis 还接受将序列日期值作为输入，但不推荐使用它们。

数据类型: char | string | datetime

版本历史记录

在 R2006a 之前推出

全部展开

R2022b: 不推荐使用序列日期值

虽然 dateaxis 支持序列日期值，但建议改用 datetime 值。datetime 数据类型提供灵活的日期和时间格式、精确到纳秒的存储，以及考虑时区和夏令时的属性。

若要将序列日期值或文本转换为 datetime 值，请使用 datetime 函数。例如：

t = datetime(738427.656845093,"ConvertFrom","datenum");
y = year(t)

y =

        2021

目前还没有停止支持序列日期值输入的计划。

另请参阅