このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。
ztickformat
z 軸の目盛りラベルの形式を指定
構文
説明
ztickformat(
は、日付または時刻を表示するラベルの形式を設定します。たとえば、datefmt
)datefmt
を 'MM-dd-yy'
として指定し、日付を 04-19-16
のように表示します。このオプションは、datetime 値をもつ z 軸にのみ適用されます。
ztickformat(
は、期間を示すラベルの形式を設定します。たとえば、durationfmt
)durationfmt
を 'm'
として指定して、分単位で期間を表示します。このオプションは、duration 値をもつ z 軸にのみ適用されます。
例
目盛りラベルをドル単位で表示
乱数データの 3 次元ステム グラフを作成します。z 軸に沿って、米国ドル単位で目盛りラベルを表示します。
z = 10*rand(5);
stem3(z)
ztickformat('usd')
目盛りラベルの形式をクエリします。MATLAB® は、書式演算子を含む文字ベクトルとして形式を返します。
fmt = ztickformat
fmt = '$%,.2f'
精度値 2 ではなく 0 を使用するように数値形式を調整することで、小数値なしで目盛りラベルを表示します。
ztickformat('$%,.0f')
各目盛りラベルの後にテキストを表示
3 次元線グラフを作成します。z 軸に沿って、各値の後にテキスト "cm" を付けて目盛りラベルを表示します。
t = 0:pi/10:10*pi; st = sin(t); ct = cos(t); plot3(st,ct,t) grid on ztickformat('%g cm')
表示される小数点以下の桁数を制御
乱数データの 3 次元散布図を作成します。小数点以下 2 桁の z 軸の目盛りラベルを表示します。固定小数点表記の変換文字と精度値 2 を使用する数値形式の文字ベクトルを ztickformat
に渡し、小数点以下の桁数を制御します。
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
を呼び出して、axes オブジェクト ax1
および ax2
を作成します。2 つの 3 次元ステム プロットを作成し、ax1
を ztickformat
の最初の入力引数として指定することで、左のプロットの z 軸の目盛りラベル形式を指定します。目盛りラベルを米国ドル単位で表示します。
tiledlayout(1,2)
ax1 = nexttile;
stem3(ax1,4*rand(5))
ztickformat(ax1,'usd')
ax2 = nexttile;
stem3(ax2,4*rand(5))
入力引数
fmt
— 数値の目盛りラベルの形式
'%g'
(既定値) | 文字ベクトル | string
数値の目盛りラベルの形式。文字ベクトルまたは string として指定します。次の表にリストされている形式のいずれかを指定できます。あるいは、カスタム形式を指定することもできます。
事前定義された形式 | 説明 |
---|---|
'usd' | 米国ドル。このオプションは、 |
'eur' | ユーロ。このオプションは、指数値 0 で |
'gbp' | 英国ポンド。このオプションは、指数値 0 で |
'jpy' | 日本円。このオプションは、指数値 0 で |
'degrees' | 値の後に度記号を表示します。このオプションは、既定の指数値で |
'percentage' | 値の後にパーセント記号を表示します。このオプションは、既定の指数値で |
'auto' | 既定の指数値を使用した |
例: ztickformat('usd')
カスタム数値形式
識別子を含む文字ベクトルまたは string を作成することで、カスタムの数値形式を指定できます。
パーセント記号と変換文字を除き、識別子の指定はオプションです。次の順序で形式を作成します。
1 つ以上のフラグ — 正の値の前にプラス記号を付けるなどのオプション。オプションの全リストについては、オプションのフラグの表を参照してください。
フィールド幅 — 目盛りラベルに出力する文字の最小数。フィールド幅は整数値として指定します。目盛り値の有効桁数がフィールド幅より小さい場合、ラベルは空白でパディングされます。
精度 — 変換文字に応じた、小数点以下の桁数または有効桁数。精度は整数値として指定します。
変換文字 — 値のタイプ。オプションの全リストについては、変換文字の表を参照してください。データに適さない変換を指定すると、MATLAB® は指定された変換をオーバーライドし、
%e
を使用します。
また、形式の先頭または末尾にリテラル テキストを指定できます。一重引用符を出力するには、''
を使用します。パーセント記号を出力するには、%%
を使用します。
例: ztickformat('%.2f')
は、小数点以下 2 桁の固定小数点表記を使用して値を表示します。
例: ztickformat('$%.2f')
は、各値の前にドル記号を表示します。
例: ztickformat('%.2f million')
は、各値の後に million
を表示します。
オプションのフラグ
識別子 | 説明 | 数値形式の例 |
---|---|---|
, | '1,000' のように 3 桁ごとにコンマを表示します。 | '%,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 として表示します。 |
datefmt
— 日付と時刻の形式
'auto'
| 文字ベクトル | string
日付と時刻の形式。'auto'
、文字ベクトル、または string として指定します。既定の形式はデータに基づきます。
例: 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 | 先頭に 0 を付けない表記の年。この表の後のメモを参照してください。 | 2014 |
yy | 下 2 桁表記の年。この表の後のメモを参照してください。 | 14 |
yyy , yyyy ... | 'y' の数に対応する桁数以上で表記した年 | 2014 年の場合、'yyy' では 2014 と表示され、'yyyyy' では 02014 と表示されます。 |
u , uu , ... | ISO 年。年を単一の数値で表したものです。ISO 年では、紀元後の年が正の値、紀元前の年が負の値で表され、紀元前 1 年が 0 年になります。 | 2014 |
Q | 1 桁表記の四半期 | 2 |
QQ | 2 桁表記の四半期 | 02 |
QQQ | 省略形で表記した四半期 | Q2 |
QQQQ | 完全名で表記した四半期 | 第2四半期 |
M | 1 桁または 2 桁の数値で表記した月 | 4 |
MM | 2 桁の数値で表記した月 | 04 |
MMM | 短縮名で表記した月 | 4月 |
MMMM | 完全名で表記した月 | 4月 |
MMMMM | 大文字の頭文字で表記した月 | A |
W | 月間通算週 | 1 |
d | 1 桁または 2 桁表記の月間通算日 | 5 |
dd | 2 桁表記の月間通算日 | 05 |
D | 1 ~ 3 桁表記の年間通算日 | 95 |
DD | 2 桁表記の年間通算日 | 95 |
DDD | 3 桁表記の年間通算日 | 095 |
e | 1 桁または 2 桁の数値で表記した曜日 | 7 (週の始まりは日曜日) |
ee | 2 桁の数値で表記した曜日 | 07 |
eee | 短縮名で表記した曜日 | 土 |
eeee | 完全名で表記した曜日 | 土曜日 |
eeeee | 先頭文字で表記した曜日 | 土 |
a | 午前と午後の区分 | 午後 |
h | 1 桁または 2 桁表記の 12 時間制の時間 | 9 |
hh | 2 桁表記の 12 時間制の時間 | 09 |
H | 1 桁または 2 桁表記の 24 時間制の時間 | 21 |
HH | 2 桁表記の 24 時間制の時間 | 21 |
m | 1 桁または 2 桁表記の分 | 41 |
mm | 2 桁表記の分 | 41 |
s | 1 桁または 2 桁表記の秒 | 6 |
ss | 2 桁表記の秒 | 06 |
S , SS , ..., SSSSSSSSS | 'S' の数に対応する桁数で表記した秒の小数部 (最大 9 桁) | 'SSS' の場合、6.12345 秒は 123 までに切り捨てられます。 |
ヒントと考慮事項:
ゼロに近い年番号を扱うときは、文字
y
の代わりに文字u
を 1 文字以上使用します。紀元後 144683 年より後または紀元前 140743 年より前の datetime 値については、指定した形式の値に関係なく、年番号のみが表示されます。
タイム ゾーン オフセットの形式
タイム ゾーン オフセットの表示形式を指定するには、次の識別子を使用します。タイム ゾーン オフセットは、特定の日付および時刻と UTC との時差です。タイム ゾーン オフセットは、その年の特定の時刻のオフセットを決定するルールを構成しているタイムゾーンとの時差です。時刻の成分が必ず明確に表示されるようにする場合は、タイム ゾーン オフセットの識別子を含めます。
文字識別子 | 説明 | 表示 |
---|---|---|
z | タイム ゾーン オフセットの省略名。この値が指定されていない場合、タイム ゾーン オフセットには UTC-4 などの短い UTC 形式が使用されます。 | EDT |
Z | ISO 8601 基本形式。時、分、秒 (オプション) の各フィールドがあります。 | -0400 |
ZZZZ | 長い UTC 形式。 | UTC-04:00 |
ZZZZZ | ISO 8601 拡張形式。時、分、秒 (オプション) の各フィールドがあります。ISO 8601 UTC 指定子 "Z" として 0 の時間オフセットが表示されます。 | -04:00 |
x または X | ISO 8601 基本形式。時、分 (オプション) の各フィールドがあります。X を指定すると、ISO 8601 UTC 指定子 "Z" として 0 の時間オフセットが表示されます。 | -04 |
xx または XX | ISO 8601 基本形式。時、分の各フィールドがあります。XX を指定すると、ISO 8601 UTC 指定子 "Z" として 0 の時間オフセットが表示されます。 | -0400 |
xxx または XXX | ISO 8601 拡張形式。時、分の各フィールドがあります。XXX を指定すると、ISO 8601 UTC 指定子 "Z" として 0 の時間オフセットが表示されます。 | -04:00 |
xxxx または XXXX | ISO 8601 基本形式。時、分、秒 (オプション) の各フィールドがあります。XXXX を指定すると、ISO 8601 UTC 指定子 "Z" として 0 の時間オフセットが表示されます。 | -0400 |
xxxxx または XXXXX | ISO 8601 拡張形式。時、分、秒 (オプション) の各フィールドがあります。XXXXX を指定すると、ISO 8601 UTC 指定子 "Z" として 0 の時間オフセットが表示されます。 | -04:00 |
durationfmt
— duration 値の形式
文字ベクトル | string
duration 値の形式。文字ベクトルまたは string として指定します。
小数部を含む 1 つの数値として期間を表示するには (1.234 時間など)、次のいずれかの形式を指定します。
形式 | 説明 |
---|---|
'y' | 固定長の正確な年数。固定長の 1 年は 365.2425 日と等しくなります。 |
'd' | 固定長の正確な日数。固定長の 1 日は 24 時間と等しくなります。 |
'h' | 時間数 |
'm' | 分の値 |
's' | 秒数 |
デジタル タイマーの形式で期間を表示するには、次のいずれかの形式を指定します。
'dd:hh:mm:ss'
'hh:mm:ss'
'mm:ss'
'hh:mm'
さらに、文字 S
を最大 9 個追加することにより、秒の小数部を最大 9 桁表示できます。たとえば、'hh:mm:ss.SSS'
は duration のミリ秒の値を 3 桁表示します。
ax
— ターゲット座標軸
Axes
オブジェクト | Axes
オブジェクトの配列
ターゲット座標軸。Axes
オブジェクトまたは Axes
オブジェクトとの配列して指定します。
この引数を指定しない場合、ztickformat
は現在の座標軸を変更します。
アルゴリズム
関数 ztickformat
は、z 軸に関連付けられたルーラー オブジェクトの TickLabelFormat
プロパティを設定およびクエリします。
バージョン履歴
R2016b で導入
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)