テキストの書式（TextFormat）

テキストの書式について説明します。
AddItemでテキストアイテムを追加する場合 TextFormat プロパティに書式を設定しておくことで、値を変換して出力することができます。

＜対応アイテム＞
テキストアイテム

＜変換指定子＞
変換指定子 説明
%@ 文字列に変換します。
%# 数値に変換します。
%g 年号に変換します。
%y 年に変換します。
%M 月に変換します。
%d 日に変換します。
%e 曜日に変換します。
%p 午前・午後に変換します。
%H 時間（24）に変換します。
%h 時間（12）に変換します。
%m 分に変換します。
%s 秒に変換します。
%〒 カスタマーバーコード用の文字に変換します。



文字列（%@）の書式

文字列を変換します。

＜構文＞
%[＜start＞][-＜count＞][v][w]@


＜オプション＞
オプション 説明
＜start＞ 出力する文字列の開始位置（1〜）を指定します。
省略した場合は先頭の文字から出力されます。
＜count＞ 出力開始位置からの出力する文字数を指定します。
省略した場合は開始位置以降の文字全てを出力します。
v 半角文字に置き換えます。
w 全角文字に置き換えます。


＜変換例＞
TextFormat=%@ 値=Abcdefg
Abcdefg

TextFormat=%4@ 値=Abcdefg
defg

TextFormat=%-3@ 値=Abcdefg
Abc

TextFormat=%2-3@ 値=Abcdefg
bcd



数値（%#）の書式

数値に変換します。
数値以外の値は欠損値として扱われます。

＜構文＞
%[+][-][0][＜width＞][,][. [0][＜cec_width＞] ][>][<][v][w]#


＜オプション＞
オプション 説明
+ 値が正の値の場合にプラス（+）を出力します。。
- 値が負の値の場合にマイナス（-）を出力しません。
0 ＜width＞または＜dec_width＞で指定した桁数に満たない場合にゼロ（0）で埋めます。
＜width＞ 整数部の桁数を指定します。ゼロ（0）埋め指定がない場合は空白（ ）で埋めます。
, 整数部を３桁毎にカンマ（,）で埋めます。
. 小数点以下の値がある場合は表示します。
＜dec_width＞ 小数点以下の桁数を指定します。ゼロ（0）埋め指定がない場合は空白（ ）で埋めます。
> ＜dec_width＞で指定した小数点桁数で切り上げます。
< ＜dec_width＞で指定した小数点桁数で切り捨てます。
v 半角文字に置き換えます。
w 全角文字に置き換えます。


＜変換例＞
TextFormat=%# 値=12345.456
12345

TextFormat=%.# 値=12345.456
12345.456

TextFormat='%,#' 値=12345.456
12,345

TextFormat=%+.06# 値=12345.456
+12345.456000



数値の書式では、値の内容によって書式自体を切り替えることができます。
この場合、書式をセミコロン（;）で区切り条件毎の書式を指定します。

＜値の内容で切り替わる書式＞
＜正の書式＞ ; ＜０の書式＞ ; ＜負の書式＞ ; ＜欠損値の書式＞


＜変換例＞
TextFormat='%#;zero;(▲%-#);empty' 値=123
123

TextFormat='%#;zero;(▲%-#);empty' 値=0
zero

TextFormat='%#;zero;(▲%-#);empty' 値=-123
(▲123)

TextFormat='%#;zero;(▲%-#);empty' 値=abc
empty


年号（%g） の書式

年号に変換します。

＜構文＞
%[＜style＞][v][w]g


＜オプション＞
オプション 説明
＜style＞ 出力スタイルを指定します。

値 説明
0 アルファベットで出力します。（例：H）
1 漢字で出力します。（例：平成）
2 省略漢字で出力します。（例：平）
v 半角文字に置き換えます。
w 全角文字に置き換えます。


＜変換例＞
TextFormat=%g 値=2016/08/01
H

TextFormat=%1g 値=2016/08/01
平成

TextFormat=%2g 値=2016/08/01
平


年（%y） の書式

年に変換します。

＜構文＞
%[＜style＞][v][w]y


＜オプション＞
オプション 説明
＜style＞ 出力スタイルを指定します。

値 説明
0 西暦4桁で出力します。
1 西暦2桁で出力します。ゼロ（0）で埋められます。
2 和暦を出力します。
3 和暦を2桁で出力します。
4 和暦を2桁で出力します。ゼロ（0）で埋められます。
v 半角文字に置き換えます。
w 全角文字に置き換えます。


＜変換例＞
TextFormat=%y 値=2016/08/01
2016

TextFormat=%1y 値=2005/08/01
05

TextFormat=%1g%2y 値=1996/08/01
平成8

TextFormat=%g%3y 値=1996/08/01
H08


月（%M） の書式

月数に変換します。

＜構文＞
%[＜style＞][v][w]M


＜オプション＞
オプション 説明
＜style＞ 出力スタイルを指定します。

値 説明
0 月数を出力します。
1 月数を2桁で出力します。
2 月数を2桁で出力します。ゼロ（0）で埋められます。
3 月数を省略英単語で出力します。（例：Jan）
4 月数を英単語で出力します。（例：January）
v 半角文字に置き換えます。
w 全角文字に置き換えます。


＜変換例＞
TextFormat=%M 値=2016/08/01
8

TextFormat=%1M 値=2016/08/01
 8

TextFormat=%2M 値=2016/08/01
08

TextFormat=%3M 値=2016/08/01
Aug

TextFormat=%4M 値=2016/08/01
August


日（%D） の書式

日数に変換します。

＜構文＞
%[＜style＞][v][w]D


＜オプション＞
オプション 説明
＜style＞ 出力スタイルを指定します。

値 説明
0 日数を出力します。
1 日数を2桁で出力します。
2 日数を2桁で出力します。ゼロ（0）で埋められます。
v 半角文字に置き換えます。
w 全角文字に置き換えます。


＜変換例＞
TextFormat=%d 値=2016/08/01
1

TextFormat=%1d 値=2016/08/01
 1

TextFormat=%2d 値=2016/08/01
01


曜日（%e） の書式

曜日に変換します。

＜構文＞
%[＜style＞][v][w]e


＜オプション＞
オプション 説明
＜style＞ 出力スタイルを指定します。

値 説明
0 省略英語で出力します。（例：Sun）
1 英単語で出力します。（例：Sunday）
2 漢字で出力します。（例：日）
v 半角文字に置き換えます。
w 全角文字に置き換えます。


午前・午後（%p） の書式

午前・午後に変換します。

＜構文＞
%[＜style＞][v][w]p


＜オプション＞
オプション 説明
＜style＞ 出力スタイルを指定します。

値 説明
0 AM・PMで出力します。
1 午前・午後で出力します。
v 半角文字に置き換えます。
w 全角文字に置き換えます。


＜変換例＞
TextFormat=%p 値=2016/08/01 09:08:07
AM

TextFormat=%1p 値=2016/08/01 09:08:07
午前


24時（%H） の書式

時数を24時間単位に変換します。

＜構文＞
%[＜style＞][v][w]H


＜オプション＞
オプション 説明
＜style＞ 出力スタイルを指定します。

値 説明
0 時数を出力します。
1 時数を2桁で出力します。
2 時数を2桁で出力します。ゼロ（0）で埋められます。
v 半角文字に置き換えます。
w 全角文字に置き換えます。


12時（%H） の書式

時数を12時間単位に変換します。

＜構文＞
%[＜style＞][v][w]h


＜オプション＞
オプション 説明
＜style＞ 出力スタイルを指定します。

値 説明
0 時数を出力します。
1 時数を2桁で出力します。
2 時数を2桁で出力します。ゼロ（0）で埋められます。
v 半角文字に置き換えます。
w 全角文字に置き換えます。


＜変換例＞
TextFormat=%h 値=2016/08/01 19:08:07
7

TextFormat=%1h 値=2016/08/01 19:08:07
 7

TextFormat=%2h 値=2016/08/01 19:08:07
07


分（%m） の書式

分数に変換します。

＜構文＞
%[＜style＞][v][w]m


＜オプション＞
オプション 説明
＜style＞ 出力スタイルを指定します。

値 説明
0 分数を出力します。
1 分数を2桁で出力します。
2 分数を2桁で出力します。ゼロ（0）で埋められます。
v 半角文字に置き換えます。
w 全角文字に置き換えます。


＜変換例＞
TextFormat=%m 値=2016/08/01 19:08:07
8

TextFormat=%1m 値=2016/08/01 19:08:07
 8

TextFormat=%2m 値=2016/08/01 19:08:07
08


秒（%s） の書式

秒数に変換します。

＜構文＞
%[＜style＞][v][w]s


＜オプション＞
オプション 説明
＜style＞ 出力スタイルを指定します。

値 説明
0 秒数を出力します。
1 秒数を2桁で出力します。
2 秒数を2桁で出力します。ゼロ（0）で埋められます。
v 半角文字に置き換えます。
w 全角文字に置き換えます。


＜変換例＞
TextFormat=%s 値=2016/08/01 19:08:07
7

TextFormat=%1s 値=2016/08/01 19:08:07
 7

TextFormat=%2s 値=2016/08/01 19:08:07
07


カスタマバーコード（%〒） の書式

カスタマバーコード用の文字列に変換します。

※
この書式変換では住所A、住所Bの切り分けを行うことができません。
したがって値に住所Aが含まれ、しかも住所Aに数値やアルファベット文字が存在する場合は、これらの情報も含まれたバーコードデータを返します。
正確に変換するには住所Aを事前に郵便番号に変換しておく必要があります。


＜構文＞
%〒


＜変換例＞
TextFormat=%〒 値=1234567 15-2丁目3番地
123456715-2-3



このページの先頭へ