DatetimeRuler 属性

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

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

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

以下是 MATLAB^® 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。

轴线和刻度线的宽度，指定为以磅为单位的正值。一磅等于 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';

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

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 函数指定刻度标签。

数据类型： char | string | categorical

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

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

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

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

以下是 MATLAB 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。

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

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 个字符。

有关使用 TeX 和 LaTeX 的示例，请参阅图文本中的希腊字母和特殊字符。有关 LaTeX 系统的详细信息，请访问 LaTeX Project 网站：https://www.latex-project.org/。

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

示例： 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 属性的选择模式，指定为下列值之一：

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

您也可以使用 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';

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

示例： ax.XAxis.FontSmoothing = 'off';

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

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

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

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

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

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

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