ztickformat
指定 z 轴刻度标签格式
语法
说明
ztickformat( 设置显示日期或时间的标签的格式。例如，将 datefmt)datefmt 指定为 'MM-dd-yy' 可显示 04-19-16 之类的日期。此选项仅适用于具有日期时间值的 z 轴。
ztickformat( 设置显示持续时间的标签的格式。例如，将 durationfmt)durationfmt 指定为 'm' 可显示以分钟为单位的持续时间。此选项仅适用于具有持续时间值的 z 轴。
示例
创建一个由随机数据组成的三维针状图。以美元符号显示沿 z 轴的刻度标签。
z = 10*rand(5);
stem3(z)
ztickformat('usd')
查询刻度标签格式。MATLAB® 返回的格式为包含格式化操作符的字符向量。
fmt = ztickformat
fmt = '$%,.2f'
通过将数值格式调整为使用精度值 0 而不是 2，可显示不带小数值的刻度标签。
ztickformat('$%,.0f')
创建一个三维线图。显示沿 z 轴的刻度标签，并在每个值后附加文本“cm”。
t = 0:pi/10:10*pi; st = sin(t); ct = cos(t); plot3(st,ct,t) grid on ztickformat('%g cm')
创建一个由随机数据组成的三维散点图。显示带两位小数的 z 轴刻度标签。通过向 ztickformat 传递一个数值格式的字符向量来控制小数位数，该数值格式对转换字符使用定点记数法且精度值为 2。
x = rand(50,1);
y = rand(50,1);
z = rand(50,1);
scatter3(x,y,z)
ztickformat('%.2f')
从 R2019b 开始，您可以使用 tiledlayout 和 nexttile 函数显示分块图。调用 tiledlayout 函数以创建 1×2 分块图布局。调用 nexttile 函数以创建坐标区对象 ax1 和 ax2。创建两个三维针状图，通过将 ax1 指定为 ztickformat 的第一个输入参量来指定左侧图的 z 轴的刻度标签格式。以美元符号显示刻度标签。
tiledlayout(1,2)
ax1 = nexttile;
stem3(ax1,4*rand(5))
ztickformat(ax1,'usd')
ax2 = nexttile;
stem3(ax2,4*rand(5))
输入参数
数值刻度标签的格式，指定为字符向量或字符串。您可以指定下表中列出的格式之一，也可以指定自定义格式。
| 预定义格式 | 描述 |
|---|---|
'usd' | 美元。此选项等同于使用 |
'eur' | 欧元。此选项等同于使用 |
'gbp' | 英镑。此选项等同于使用 |
'jpy' | 日元。此选项等同于使用 |
'degrees' | 在值之后显示度符号。此选项等同于使用 |
'percentage' | 在值之后显示百分号。此选项等同于使用 |
'auto' |
|
示例: ztickformat('usd')
自定义数值格式
您可以通过创建包含标识符的字符向量或字符串来指定自定义数值格式。
标识符是可选的，百分比符号和转换字符除外。按以下顺序构造格式：
您还可以在格式的开头或末尾指定字面文本。要打印单引号，请使用 ''。要打印百分比字符，请使用 %%。
示例：ztickformat('%.2f') 使用带两个小数位的定点记数法显示值。
示例：ztickformat('$%.2f') 在每个值前面显示美元符号。
示例：ztickformat('%.2f million') 在每个值后面显示 million。
可选标志
| 标识符 | 描述 | 数值格式示例 |
|---|---|---|
, | 每隔三位数显示一个逗号，例如 '1,000'。 | '%,4.4g' |
+ | 为正值打印符号字符 (+)，例如 '+100'。 | '%+4.4g' |
0 | 用前导零而不是空格填充字段宽度，例如 '0100'。 | '%04.4g' |
– | 左对齐，在值的末尾而不是开头用空格填充。例如，如果字段宽度为 4，则此标志将标签格式化为 '100 '，而不是 ' 100'。 | '%-4.4g' |
# | 对于 | '%#4.4g' |
转换字符
| 标识符 | 描述 | 示例 |
|---|---|---|
d 或 i | 底数为 10 的有符号整数。精度值指示有效位数。 | '%.4d' 将 π 显示为 0003。 |
f | 定点记数法。精度值指示小数位数。 | '%.4f' 将 π 显示为 3.1416。 |
e | 指数记数法。精度值指示小数位数。 | '%.4e' 将 π 显示为 3.1416x100。 |
g | 更精简版本的 e 或 f，不带尾随零。精度值指示最大小数位数。 | '%.4g' 将 π 显示为 3.1416。 |
日期和时间的格式，指定为 'auto'、字符向量或字符串。默认格式基于数据。
示例: ztickformat('yyyy-MM-dd') 显示日期和时间，例如 2016-04-19。
示例: ztickformat('eeee, MMMM d, yyyy HH:mm:ss') 显示日期和时间，例如 Saturday, April 19, 2016 21:41:06。
示例: ztickformat('MMMM d, yyyy HH:mm:ss Z') 显示日期和时间，例如 April 19, 2016 21:41:06 -0400。
显示格式表列出了可用于构造格式的字母标识符。要分隔字段，可以包括非字母字符，例如连字符、空格、冒号或任何非 ASCII 字符。这些标识符遵从日期的 Unicode® 区域数据标记语言 (LDML) 标准。
日期和时间格式
使用这些标识符指定日期和时间字段的显示格式。
| 字母标识符 | 描述 | 显示 |
|---|---|---|
G | 年代 | CE |
y | 年份，没有前导零。请参阅紧随此表后的“注释”。 | 2014 |
yy | 年份，使用最后两位数。请参阅紧随此表后的“注释”。 | 14 |
yyy, yyyy ... | 年份，至少使用 'y' 实例数指定的位数 | 对于年份 2014，'yyy' 显示 2014，而 'yyyyy' 则显示 02014。 |
u, uu, ... | ISO 年份。单个数字来指定年份。ISO 年份值将正数值分配给 CE 年份，将负数值分配给 BCE 年份，1 BCE 表示年份 0。 | 2014 |
Q | 季度，使用一位数 | 2 |
QQ | 季度，使用两位数 | 02 |
QQQ | 季度，缩写 | 2 季度 |
QQQQ | 季度，全名 | 第二季度 |
M | 月份，使用一位或两位数字 | 4 |
MM | 月份，使用两位数字 | 04 |
MMM | 月份，缩写名称 | 四月 |
MMMM | 月份，全名 | 四月 |
MMMMM | 月份，首字母大写 | A |
W | 一月中的第几周 | 1 |
d | 一月中的第几天，使用一位或两位数 | 5 |
dd | 一月中的第几天，使用两位数 | 05 |
D | 一年中的第几天，使用一位、两位或三位数 | 95 |
DD | 一年中的第几天，使用两位数 | 95 |
DDD | 一年中的第几天，使用三位数 | 095 |
e | 一周中的星期几，使用一位或两位数的数值。 | 7，星期日是一周中的第一天。 |
ee | 一周中的星期几，使用两位数字 | 07 |
eee | 星期几，缩写名称 | 周六 |
eeee | 星期几，全名 | 星期六 |
eeeee | 星期几，使用一位大写数字 | 六 |
a | 一天中的时段（上午或下午） | 下午 |
h | 小时，采用 12 小时制格式，使用一位或两位数 | 9 |
hh | 小时，采用 12 小时制格式，使用两位数 | 09 |
H | 小时，采用 24 小时制格式，使用一位或两位数 | 21 |
HH | 小时，采用 24 小时制格式，使用两位数 | 21 |
m | 分钟，使用一位或两位数 | 41 |
mm | 分钟，使用两位数 | 41 |
s | 秒，使用一位或两位数 | 6 |
ss | 秒，使用两位数 | 06 |
S, SS, ..., SSSSSSSSS | 小数秒，使用 'S' 个数所指定的位数（最多 9 位）。 | 'SSS' 将 6.12345 秒截断为 123。 |
一些提示和注意事项：
使用一个或多个
u字符而非y字符在使用接近零的年份数时解释年份。公元 144683 年之后或公元前 140743 年之前的日期时间值仅显示年份数，而不管指定的格式值为何。
时区偏移量格式
使用这些标识符指定时区偏移量的显示格式。时区偏移量是指具体日期和时间与 UTC 之间相差的时间量。时区偏移量不同于时区，因为它包含了决定一年特定时间的偏移量的规则。若要确保明确地显示时间，请加上时区偏移量标识符。
| 字母标识符 | 描述 | 显示 |
|---|---|---|
z | 时区偏移量的缩写名称。如果此值不可用，则时区偏移量使用短 UTC 格式，例如 UTC-4。 | EDT |
Z | ISO 8601 基本格式，带有小时、分钟和可选的秒字段。 | -0400 |
ZZZZ | 长 UTC 格式。 | UTC-04:00 |
ZZZZZ | ISO 8601 扩展格式，带有小时、分钟和可选的秒字段。以 ISO 8601 标准规定的 UTC 指示符 "Z" 的形式来显示与零时区的偏移量。 | -04:00 |
x 或 X | ISO 8601 基本格式，带有小时字段和可选的分钟字段。如果您指定 X，则以 ISO 8601 标准规定的 UTC 指示符 "Z" 的形式来显示与零时区的偏移量。 | -04 |
xx 或 XX | ISO 8601 基本格式，带有小时和分钟字段。如果您指定 XX，则以 ISO 8601 标准规定的 UTC 指示符 "Z" 的形式来显示与零时区的偏移量。 | -0400 |
xxx 或 XXX | ISO 8601 扩展格式，带有小时和分钟字段。如果您指定 XXX，则以 ISO 8601 标准规定的 UTC 指示符 "Z" 的形式来显示与零时区的偏移量。 | -04:00 |
xxxx 或 XXXX | ISO 8601 基本格式，带有小时、分钟和可选的秒字段。如果您指定 XXXX，则以 ISO 8601 标准规定的 UTC 指示符 "Z" 的形式来显示与零时区的偏移量。 | -0400 |
xxxxx 或 XXXXX | ISO 8601 扩展格式，带有小时、分钟和可选的秒字段。如果您指定 XXXXX，则以 ISO 8601 标准规定的 UTC 指示符 "Z" 的形式来显示与零时区的偏移量。 | -04:00 |
持续时间值的格式，指定为字符向量或字符串。
要将持续时间显示为包含小数部分（例如 1.234 小时）的单个数字，请指定下列格式之一。
| 格式 | 描述 |
|---|---|
'y' | 精确固定长度的年份的数目。固定长度的一年等于 365.2425 天。 |
'd' | 精确固定长度的天数的数目。固定长度的一天等于 24 小时。 |
'h' | 小时数 |
'm' | 分钟数 |
's' | 秒数 |
要以数字计时器的形式显示持续时间，请指定下列格式之一：
'dd:hh:mm:ss''hh:mm:ss''mm:ss''hh:mm'
此外，可以通过附加多达 9 个 S 字符显示多达 9 位小数的秒位。例如，'hh:mm:ss.SSS' 以三位数显示持续时间的毫秒数。
目标坐标区，指定为 Axes 对象或 Axes 对象数组。
如果不指定此参量，则 ztickformat 会修改当前坐标区。
算法
ztickformat 函数设置并查询与 z 轴相关联的标尺对象的 TickLabelFormat 属性。
版本历史记录
在 R2016b 中推出
