テキストの書式

テキストの書式について説明します。


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



文字列（%@）の書式

文字列を変換します。

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


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


＜変換例＞
書式=%@ 値=Abcdefg
Abcdefg

書式=%4@ 値=Abcdefg
defg

書式=%-3@ 値=Abcdefg
Abc

書式=%2-3@ 値=Abcdefg
bcd



数値（%#）の書式

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

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


＜オプション＞
オプション 説明
+ 値が正の値の場合にプラス（+）を出力します。。
- 値が負の値の場合にマイナス（-）を出力しません。
0 ＜width＞または＜dec_width＞で指定した桁数に満たない場合にゼロ（0）で埋めます。
＜width＞ 整数部の桁数を指定します。ゼロ（0）埋め指定がない場合は空白（ ）で埋めます。
, 整数部を３桁毎にカンマ（,）で埋めます。
. 小数点以下の値がある場合は表示します。

※
小数点表示をする場合は小数点以下桁数を指定することをお勧めいたします。
WFRでは数値をdouble型を使って扱っています。
このため演算結果によっては微少なゴミが含まれる場合があります。
数値書式で「.」（ピリオド）だけを指定するとゴミも含め全て出力されてしまいます。
＜dec_width＞ 小数点以下の桁数を指定します。ゼロ（0）埋め指定がない場合は空白（ ）で埋めます。
> ＜dec_width＞で指定した小数点桁数で切り上げます。
< ＜dec_width＞で指定した小数点桁数で切り捨てます。
v 半角文字に置き換えます。
w 全角文字に置き換えます。


＜変換例＞
書式=%# 値=12345.456
12345

書式=%.# 値=12345.456
12345.456

書式='%,#' 値=12345.456
12,345

書式=%+.06# 値=12345.456
+12345.456000



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

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


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

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

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

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


年号（%g） の書式

年号に変換します。

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


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

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


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

書式=%1g 値=2016/08/01
平成

書式=%2g 値=2016/08/01
平


年（%y） の書式

年に変換します。

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


＜オプション＞
オプション 説明
元 和暦表示で「1」年を「元」年に置き換えて出力します。

1989年 を書式「%1G%元2y」で変換すると ”平成元年” と出力
＜style＞ 出力スタイルを指定します。

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


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

書式=%1y 値=2005/08/01
05

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

書式=%1g%元2y年 値=1989/08/01
平成元年

書式=%g%3y 値=1996/08/01
H08


月（%M） の書式

月数に変換します。

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


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

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


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

書式=%1M 値=2016/08/01
 8

書式=%2M 値=2016/08/01
08

書式=%3M 値=2016/08/01
Aug

書式=%4M 値=2016/08/01
August


日（%D） の書式

日数に変換します。

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


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

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


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

書式=%1d 値=2016/08/01
 1

書式=%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 全角文字に置き換えます。


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

書式=%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 全角文字に置き換えます。


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

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

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


分（%m） の書式

分数に変換します。

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


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

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


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

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

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


秒（%s） の書式

秒数に変換します。

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


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

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


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

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

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


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

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

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


＜構文＞
%〒


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



このページの先頭へ