xtickformat

Задайте x формат метки деления оси

Описание

пример

xtickformat(fmt) устанавливает формат для числовых меток такта по оси X. Для примера задайте fmt как 'usd' отображение меток в долларах США.

пример

xtickformat(datefmt) устанавливает формат меток, показывающих даты или время. Для примера задайте datefmt как 'MM-dd-yy' для отображения таких дат, как 04-19-16. Эта опция применяется только к оси X с значениями datetime.

пример

xtickformat(durationfmt) устанавливает формат для меток, показывающих длительности. Для примера задайте durationfmt как 'm' отображение длительности в минутах. Эта опция применяется только к оси X со значениями длительности.

пример

xtickformat(ax,___) использует оси, заданные как ax вместо текущей системы координат. Задайте ax в качестве первого входного параметра.

пример

xfmt = xtickformat возвращает стиль формата, используемый для меток такта на оси X текущих систем координат. В зависимости от типа меток вдоль оси X, xfmt - вектор символов числового формата, формата даты или формата длительности.

xfmt = xtickformat(ax) возвращает стиль формата, используемый для заданных в ax осей вместо текущей системы координат.

Примеры

свернуть все

Отобразите метки такта на оси X в долларах с десятичными значениями и без них.

Создайте столбчатую диаграмму. Отображение меток такта вдоль оси X в долларах.

x = 0:20:100;
y = [88 67 98 43 45 65];
bar(x,y)
xtickformat('usd')

Figure contains an axes. The axes contains an object of type bar.

Запросите формат метки такта. MATLAB ® возвращает формат как вектор символов, содержащий операторы форматирования.

fmt = xtickformat
fmt = 
'$%,.2f'

Отображение меток такта без десятичного числа значений путем изменения числового формата, чтобы использовать значение точности 0 вместо 2.

xtickformat('$%,.0f')

Figure contains an axes. The axes contains an object of type bar.

После создания линии графика отобразите метки такта вдоль оси X с текстом «GHz» после каждого значения.

x = 1:10;
y = [.17 .25 .27 .28 .3 .32 .33 .34 .345 .35];
plot(x,y,'-V')
xtickformat('%g GHz')

Figure contains an axes. The axes contains an object of type line.

После создания графика поля точек отобразите метки такта по оси X с двумя десятичными знаками. Управляйте десятичными знаками путем прохождения xtickformat вектор символов числового формата, который использует обозначение с фиксированной точкой для символа преобразования и значения точности 2.

x = linspace(0,1,100);
y = randn(1,100).*cos(x);
scatter(x,y)
xtickformat('%.2f')

Figure contains an axes. The axes contains an object of type scatter.

Создайте линейный график со значениями datetime вдоль оси X. Затем измените формат дат.

t = datetime(2014,6,28) + caldays(1:10);
y = rand(1,10);
plot(t,y);
xtickformat('MM-dd')

Figure contains an axes. The axes contains an object of type line.

Создайте линейный график со значениями длительности вдоль оси X. Затем измените формат меток тактов.

t = 0:seconds(30):minutes(3);
y = rand(1,7);
plot(t,y)
xtickformat('mm:ss')

Figure contains an axes. The axes contains an object of type line.

Создайте график поля точек и отобразите метки такта оси X в Евро. Затем запросите формат метки такта. MATLAB ® возвращает формат как вектор символов, содержащий операторы форматирования .

x = rand(100,1);
y = rand(100,1);
scatter(x,y)
xtickformat('eur')

Figure contains an axes. The axes contains an object of type scatter.

xfmt = xtickformat
xfmt = 
'\x20AC%,.2f'

Начиная с R2019b, можно отобразить плиточное размещение графиков с помощью tiledlayout и nexttile функций. Вызовите tiledlayout функция для создания мозаичного графика размещения 2 на 1. Вызовите nexttile функция для создания объектов осей ax1 и ax2. Постройте график в каждой из осей. Задайте формат метки такта для оси X нижнего графика путем определения ax2 как первый входной параметр для xtickformat. Отображение меток такта в долларах США.

tiledlayout(2,1)
ax1 = nexttile;
plot(ax1,rand(6))

ax2 = nexttile;
plot(ax2,rand(6))
xtickformat(ax2,'usd')

Figure contains 2 axes. Axes 1 contains 6 objects of type line. Axes 2 contains 6 objects of type line.

Входные параметры

свернуть все

Формат для меток числовых тактов, заданный как вектор символов или строковый скаляр. Можно задать один из форматов, перечисленных в этой таблице. Также можно задать пользовательский формат.

Предопределенный форматОписание
'usd'

долларов США. Эта опция эквивалентна использованию '$%,.2f'. Если в метках используется научное обозначение, эта опция устанавливает значение экспоненты равным 0.

'eur'

Евро. Эта опция эквивалентна использованию '\x20AC%,.2f' со значением экспоненты 0.

'gbp'

Британский фунт. Эта опция эквивалентна использованию '\x00A3%,.2f' со значением экспоненты 0.

'jpy'

Японская иена. Эта опция эквивалентна использованию '\x00A5%,d' со значением экспоненты 0.

'degrees'

Отобразите символ степени после значений. Эта опция эквивалентна использованию '%g\x00B0' со значением экспоненты по умолчанию.

'percentage'

Отображение процентного знака после значений. Эта опция эквивалентна использованию '%g%%' со значением экспоненты по умолчанию.

'auto'

Формат по умолчанию '%g' со значением экспоненты по умолчанию.

Пример: xtickformat('usd')

Пользовательский числовой формат

Вы можете задать пользовательский числовой формат, создав вектор символов или строку, содержащую идентификаторы.

Идентификаторы являются необязательными, кроме знака процента и символа преобразования. Создайте формат в следующем порядке:

  • Один или несколько флагов - опции, как добавление знака плюс перед положительными значениями. Полный список опций см. в таблице Необязательные флаги.

  • Ширина поля - минимальное количество символов для печати в метке такта. Задайте ширину поля как целое значение. Если количество значащих цифр в значении деления меньше ширины поля, метка заполняется пробелами.

  • Точность - количество цифр справа от десятичной точки или количество значащих цифр, в зависимости от символа преобразования. Задайте точность как целое значение.

  • Символ преобразования - Тип значения. Полный список опций см. в таблице символов преобразования. Если вы задаете преобразование, которое не соответствует данным, то MATLAB® переопределяет заданное преобразование и использует %e.

Кроме того, вы можете задать буквенный текст в начале или конце формата. Для печати одиночного кавычки используйте ''. Чтобы напечатать процентный символ, используйте %%.

Пример: xtickformat('%.2f') отображает значения с использованием обозначения с фиксированной точкой с двух десятичных чисел местами.

Пример: xtickformat('$%.2f') отображает знак доллара перед каждым значением.

Пример: xtickformat('%.2f million') отображает million после каждого значения.

Необязательные флаги

ИдентификаторОписаниеПример числового формата
,Отображать запятые каждые три цифры, такие как '1,000'.'%,4.4g'
+Напечатайте символ (+) для положительных значений, таких как '+100'.'%+4.4g'
0Дополните ширину поля начальными нулями вместо пространств, такими как '0100'.'%04.4g'
Выравнивание влево, которое заполняет конец значения пространства вместо начала. Для примера, если ширина поля 4, затем этот флаг форматирует метку следующим '100 ' вместо ' 100'.'%-4.4g'
#

Для %f, %e, и %g символы преобразования, напечатайте десятичную точку, даже когда точность равна 0, например '100.'. Для %g, не удаляйте конечные нули.

'%#4.4g'

Символы преобразования

ИдентификаторОписаниеПример
d или iЦелое число со знаком с основой 10. Значение точности указывает количество значащих цифр. '%.4d' отображает, как 0003.
fОбозначение с фиксированной точкой. Значение точности указывает количество десятичных знаков.'%.4f' отображает, как 3.1416.
eЭкспоненциальное обозначение. Значение точности указывает количество десятичных знаков.'%.4e' отображает, как 3.1416x100.
gБолее компактная версия e или f, без конечных нулей. Значение точности указывает максимальное количество десятичных знаков.'%.4g' отображает, как 3.1416.

Формат дат и времени, заданный как 'auto', вектор символов или строковый скаляр. Формат по умолчанию основан на данных.

Пример: xtickformat('yyyy-MM-dd') отображает дату и время, такие как 2016-04-19.

Пример: xtickformat('eeee, MMMM d, yyyy HH:mm:ss') отображает дату и время, такие как Saturday, April 19, 2016 21:41:06.

Пример: xtickformat('MMMM d, yyyy HH:mm:ss Z') отображает дату и время, такие как April 19, 2016 21:41:06 -0400.

В таблицах формата отображения показаны идентификаторы букв, которые можно использовать для создания формата. Чтобы разделить поля, можно включать небукву символы, такие как дефис, пространство, двоеточие или любые символы, отличные от ASCII. Идентификаторы соответствуют Юникоду® Язык разметки данных локали (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Квартал, сокращённоQ2
QQQQКвартал, полное имя2nd quarter
MМесяц, численный с использованием одной или двух цифр4
MMМесяц, численный с использованием двух цифр04
MMMМесяц, сокращенное имяApr
MMMMМесяц, полное имяApril
MMMMMМесяц, заглавная первая букваA
WНеделя месяца1
dДень месяца, использование одной или двух цифр5
ddДень месяца с использованием двух цифр05
DДень года, использование одной, двух или трех цифр95
DDДень года с использованием двух цифр95
DDDДень года с использованием трех цифр095
eДень недели, численный с использованием одной или двух цифр.7, где воскресенье - первый день недели.
eeДень недели, численный с использованием двух цифр07
eeeДень, сокращенное имяSat
eeeeДень, полное имяSaturday
eeeeeДень, заглавная первая букваS
aДневной период (AM или PM)PM
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 символы для представления года при работе с номерами лет около нуля.

  • Значения datetime позднее 144683 лет CE или до 140743 BCE отображают только номера года, независимо от заданного значения формата.

Форматы смещения часового пояса

Используйте эти идентификаторы, чтобы задать формат отображения смещения часового пояса. Смещение часового пояса - это количество времени, в течение которого определенная дата и время смещаются от 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 или XISO 8601 базовый формат с полем часов и полем дополнительных минут. Если вы задаете Xсмещение нуля по времени отображается как индикатор ISO 8601 UTC «Z».-04
xx или XXISO 8601 базовый формат с часами и минутами полей. Если вы задаете XXсмещение нуля по времени отображается как индикатор ISO 8601 UTC «Z».-0400
xxx или XXXISO 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'

В сложение можно отобразить до девяти дробных вторых цифр, добавив до девяти S персонажи. Для примера, 'hh:mm:ss.SSS' отображает миллисекунды от значения длительности до трех цифр.

Целевые оси, заданные как Axes объект или массив Axes объекты.

Если вы не задаете этот аргумент, то xtickformat изменяет текущую систему координат.

Алгоритмы

The xtickformat функция устанавливает и запрашивает TickLabelFormat свойство объекта линейки, сопоставленное с осью X.

Введенный в R2016b
Для просмотра документации необходимо авторизоваться на сайте