DatetimeRuler 属性

轴线和标签的颜色，指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。

对于自定义颜色，请指定 RGB 三元组或十六进制颜色代码。

此外，还可以按名称指定一些常见的颜色。下表列出了一些命名颜色选项、其等效 RGB 三元组及十六进制颜色代码。

下表列出了浅色和深色主题中绘图的默认调色板。

您可以使用 orderedcolors 和 rgb2hex 函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如，获取 "gem" 调色板的 RGB 三元组并将其转换为十六进制颜色代码。

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder") 获取 RGB 三元组。

在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255)) 获取十六进制颜色代码。

轴线和刻度线的宽度，指定为以磅为单位的正值。一磅等于 1/72 英寸。

示例: ax.XAxis.LineWidth = 2;

轴标签，它是一个文本对象。要显示文本或更改现有文本，请设置文本对象的 String 属性。使用其他属性更改文本外观，例如字体样式或颜色。

ax = gca;
ax.XAxis.Label.String = 'X Axis';
ax.XAxis.Label.FontSize = 12;

如需完整的选项列表，请参阅 Text 属性。

或者，使用 xlabel、ylabel 和 zlabel 函数添加或修改轴标签。

轴标签水平对齐，指定为表中的值之一。

轴可见性，指定为 'on' 或 'off'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

示例: ax.XAxis.Visible = 'off';

最小和最大坐标轴范围，指定为 [min max] 形式的二元素向量，其中 min 和 max 是日期时间值。例如：

t = datetime(2014,6,28) + caldays(1:10);
y = rand(1,10);
plot(t,y);
ax = gca;
ax.XAxis.Limits = [t(2) t(8)];

或者，使用 xlim、ylim 和 zlim 函数设置范围。

如果您赋值给此属性，则 MATLAB^® 会将相关联的模式设置为 'manual'。

Limits 属性的选择模式，指定为下列值之一：

值沿轴的刻度，返回 'linear'。DatetimeRuler 对象不支持对数标度。

增加值的方向，指定为下列值之一：

示例: ax.XAxis.Direction = 'reverse';

参考日期，指定为日期时间值。此属性对于同步不同坐标区上的刻度位置以及一起绘制不同时区的数据非常有用。

MATLAB 在绘制到坐标区中的第一个数据集的时区中显示绘图。要更改绘图的时区，请将 ReferenceDate 属性设置为具有所需时区的日期时间值。

示例

对纽约和伦敦新年狂欢者的数量绘图。生成的绘图采用纽约的时区。

NY = datetime(2021,1,1,0:17,0,0,"TimeZone","America/New_York");
London = datetime(2021,1,1,0:17,0,0,"TimeZone","Europe/London");
ax = axes;
y = (1./(1:18).^2) * 100000;
semilogy(ax,NY,y,London,y)
grid on

通过将 ReferenceDate 属性设置为时区为 "Europe/London" 的日期时间值，使绘图改用伦敦的时区。然后添加图例和标题。

ax.XAxis.ReferenceDate = datetime(2022,1,1,"TimeZone","Europe/London");
legend("New York","London")
title("New Year's Day Revelers")

轴的刻度线位置，指定为日期时间值的向量。例如：

t = datetime(2014,6,28) + caldays(1:10);
y = rand(1,10);
plot(t,y);
ax = gca;
ax.XAxis.TickValues = [t(1) t(3) t(5) t(10)];

如果您为此属性赋值，则 MATLAB 会将 TickValuesMode 属性设置为 'manual'。

或者，使用 xticks、yticks 和 zticks 函数。

TickValues 属性的选择模式，指定为下列值之一：

刻度线标签，指定为字符向量元胞数组、字符串数组或分类数组。如果您没有为所有刻度值指定足够多的标签，将会重复使用标签。标签支持 TeX 和 LaTeX 标记。有关详细信息，请参阅 TickLabelInterpreter 属性。

示例: ax.XAxis.TickLabels = {'January','February','March','April','May'}';

示例: ax.YAxis.TickLabels = {'\pi','2\pi','3\pi'}'

如果您设置此属性，则 MATLAB 会将 TickLabelsMode 属性设置为 'manual'。

或者，使用 xticklabels、yticklabels 和 zticklabels 函数指定刻度标签。

TickLabels 属性的选择模式，指定为下列值之一：

刻度标签颜色，指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。

对于自定义颜色，请指定 RGB 三元组或十六进制颜色代码。

此外，还可以按名称指定一些常见的颜色。下表列出了一些命名颜色选项、其等效 RGB 三元组及十六进制颜色代码。

下表列出了浅色和深色主题中绘图的默认调色板。

您可以使用 orderedcolors 和 rgb2hex 函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如，获取 "gem" 调色板的 RGB 三元组并将其转换为十六进制颜色代码。

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder") 获取 RGB 三元组。

在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255)) 获取十六进制颜色代码。

刻度标签解释器，指定为下列值之一：

TeX 标记

默认情况下，MATLAB 支持一部分 TeX 标记。使用 TeX 标记可添加下标和上标，修改文本类型和颜色，并在文本中包括特殊字符。

修饰符会一直作用到文本结尾，但上标和下标除外，因为它们仅修饰下一个字符或花括号中的字符。当您将解释器设置为 "tex" 时，支持的修饰符如下所示。

下表列出了 "tex" 解释器所支持的特殊字符。

LaTeX 标记

要使用 LaTeX 标记，请将 TickLabelInterpreter 属性设置为 'latex'。使用美元符号将标签括起来，例如，对于行内模式，使用 '$\int_1^{20} x^2 dx$'；对于行间模式，使用 '$$\int_1^{20} x^2 dx$$'。

显示的文本将使用默认的 LaTeX 字体样式。FontName、FontWeight 和 FontAngle 属性不起任何作用。要更改字体样式，请在文本中使用 LaTeX 标记。用于 LaTeX 解释器的文本最多可以包含 1200 个字符。对于多行文本，需在此基础上每行再减少约 10 个字符。

MATLAB 支持大多数标准 LaTeX 数学模式命令。有关详细信息，请参阅支持的 LaTeX 命令。有关使用 TeX 和 LaTeX 的示例，请参阅图文本中的希腊字母和特殊字符。

刻度标签格式，指定为字符串或字符向量。默认格式基于数据。

示例: ax.XAxis.TickLabelFormat = "yyyy-MM-dd"; 显示日期和时间，例如 2014-04-19。

示例: ax.XAxis.TickLabelFormat = "eeee, MMMM d, yyyy HH:mm:ss"; 显示日期和时间，例如 Saturday, April 19, 2014 21:41:06。

示例: ax.XAxis.TickLabelFormat = "MMMM d, yyyy HH:mm:ss Z"; 显示日期和时间，例如 April 19, 2014 21:41:06 -0400。

下表显示了可用于构造格式的字母标识符。可以使用连字符、空格、冒号或任何非 ASCII 字符等非字母字符来分隔字段。这些标识符遵从日期的 Unicode^® 区域数据标记语言 (LDML) 标准。

日期和时间格式

使用这些标识符指定日期和时间字段的显示格式。

一些提示和注意事项：

时区偏移量格式

使用这些标识符指定时区偏移量的显示格式。时区偏移量是指具体日期和时间与 UTC 之间相差的时间量。这不同于时区，时区包含确定一年特定时间的偏移量的规则。若要确保明确地显示时间，请加上时区偏移量标识符。

TickLabelFormat 属性的选择模式，指定为下列值之一：

次级标签格式，指定为字符串标量或字符向量。次级标签出现在刻度标签旁边的留白中。您可以使用此属性来自定义标签的格式。默认格式基于数据。要删除次级标签，请指定空字符串 ("")。

如果指定次级标签格式，刻度标签可能会更新以避免显示冗余信息。例如，如果绘制几个日期并在次级标签中显示月份，则刻度标签会更新以显示没有月份的日期数字。

示例: ax.XAxis.SecondaryLabelFormat = "MMMM" 显示月份名称。

示例: ax.XAxis.SecondaryLabelFormat = "ZZZZ" 显示时区偏移量。

下表显示了可用于构造格式的字母标识符。可以使用连字符、空格、冒号或任何非 ASCII 字符等非字母字符来分隔字段。这些标识符遵从日期的 Unicode 区域数据标记语言 (LDML) 标准。

日期和时间格式

使用这些标识符指定日期和时间字段的显示格式。

一些提示和注意事项：

时区偏移量格式

使用这些标识符指定时区偏移量的显示格式。时区偏移量是指具体日期和时间与 UTC 之间相差的时间量。这不同于时区，时区包含确定一年特定时间的偏移量的规则。若要确保明确地显示时间，请加上时区偏移量标识符。

SecondaryLabelFormat 属性的选择模式，指定为下列值之一：

刻度标签旋转，指定为以度为单位的标量值。正值将导致按逆时针旋转。负值产生顺时针旋转。

您也可以使用 xtickangle、ytickangle 和 ztickangle 函数旋转刻度标签。

示例: ax.XAxis.TickLabelRotation = 45;

示例: ax.YAxis.TickLabelRotation = -45;

TickLabelRotation 属性的选择模式，指定为下列值之一：

刻度线方向，指定为下列值之一：

如果您为此属性赋值，则 MATLAB 会将 TickDirectionMode 属性设置为 'manual'。

TickDirection 属性的选择模式，指定为下列值之一：

刻度线长度，指定为 [2Dlength 3Dlength] 形式的二元素向量。第一个元素是二维视图中的刻度线长度。第二个元素是三维视图中的刻度线长度。指定值时采用的是以坐标区最长维度为基准的归一化单位。

示例: ax.YAxis.TickLength = [0.02 0.035];

次刻度线显示方式，指定为 'on' 或 'off'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

示例: ax.XAxis.MinorTick = 'on';

次刻度线位置，指定为由递增日期时间值组成的向量。

如果您赋值给此属性，则 MATLAB 会将 MinorTickValuesMode 属性设置为 'manual'。

MinorTickValues 属性的选择模式，指定为下列值之一：

字体名称，指定为系统支持的字体名称或 'FixedWidth'。默认字体取决于特定的操作系统和区域设置。要使用渲染效果好的等宽字体，请指定 'FixedWidth'。使用的实际等宽字体取决于根对象的 FixedWidthFontName 属性。

示例: ax.XAxis.FontName = 'Cambria';

字体大小，指定为数值标量。默认字体大小取决于具体操作系统和区域设置。

示例: ax.XAxis.FontSize = 12;

文本字符的粗细，指定为下列值之一：

MATLAB 使用 FontWeight 属性从系统提供的字体中选择一种字体。并非所有字体都有加粗字体。因此，指定加粗字体仍可能得到普通字体。

示例: ax.XAxis.FontWeight = 'bold';

字符倾斜，指定为 'normal' 或 'italic'。并非所有字体都有两种字体样式。因此，斜体可能看上去与常规字体一样。

示例: ax.XAxis.FontAngle = 'italic';

坐标轴范围更改后执行的回调，指定为下列值之一：

此回调在坐标轴范围更改后执行，或以编程方式执行，或使用交互（例如在坐标区内平移）执行。当您调用绘图函数时，如果 MATLAB 更改坐标轴范围以包含您的数据范围，也会执行此回调。

此回调函数可以访问有关轴范围的特定信息。MATLAB 在 LimitsChanged 对象中将此信息作为第二个参量传递给回调函数。如果您在 App 设计工具中开发 App，该参量称为 event。您可以使用圆点表示法查询对象属性。例如，event.NewLimits 返回新坐标轴范围。LimitsChanged 对象不可用于指定为字符向量的回调函数。

下表列出了 LimitsChanged 对象的属性。

有关在 App 中编写回调的详细信息，请参阅App 设计工具中的回调。

标尺的父级，指定为 Axes 对象。

标尺没有任何子级。您不能设置该属性。