format¶

表示文字列のフォーマットを指定します。

subTypeが無指定、StringまたはNativeStringの場合

指定文字	例	説明
@	`"@\"様\""`	デフォルトの書式で指定位置に表示します。
`"TEXT"`	`"\"題名:\"@"`	`""` で括った文字を指定位置に表示します。 (注: `"` で括ったCRS文字列定数中で `"` を指定するためには `\"` と記述する必要があります。)
Sn.m	`"S2.3"`	文字列の左端を0として数え、n文字目からm文字分の文字を表示します。

subTypeがNumber、またはFixedの場合

指定文字	例	説明
9	"999"	9を記述した数は桁数を示し、先行0は削除されます。小数点以下に指定した場合桁数に満たない場合、後方0は削除されます。
0	"0999"、"9990"	先行0は0となります。小数点以下に指定した場合、桁数に満たない場合、0埋めされます。
$	"$9990"	先頭に$マークを付加します。
MI	"999MI"、"MI999"	負数の場合に、指定位置（右か左）にマイナス記号（-）を表示します。
S	"S9990"、"9990S"	指定位置（右か左）に符号を表示します。
Dまたは.（ピリオド）	"99D99"、"99.99"	指定の位置に小数点を表示します。小数点以下の桁数を指定しない場合は有効精度の範囲内で最後の数字までを表示します。
L	"L9990"、"9990L"	指定位置（右か左）にローカル通貨記号を表示します。
,（カンマ）	"999,990"	3桁ごとにカンマを表示します。
" "(スペース)	" 99"	スペースを記述した数は桁数を示し、先行0は空白文字（スペース）に置き換えられます。小数点以下に指定した場合は無効で意味を持ちません。
!	"999!"	指定桁数の範囲で桁あふれが発生した場合に書式化した結果に!が付与されて表示されますが、!を指定すると桁あふれした場合でも!の表示が抑止されます。
@	`"@"`	デフォルトの書式で表示します。
`"テキスト"`	`"9990\"円\""`	`""` で括った文字を指定位置に表示します。 (注: `"` で括ったCRS文字列定数中で `"` を指定するためには `\"` と記述する必要があります。)

subTypeがDateの場合

指定文字	例	説明
Y	`"YYYY,MM,DD"`	西暦の年を表示します。Yを記述した数(最大4文字)は西暦の表示桁数を示します。
WS	`"WSWYY.MM.DD"`	和暦の年号を省略形（M ,T, S, H, R...）で表示します。
WR	`"WRWYY\"年\"MM\"月\"DD\"日\""`	和暦の年号を（明治、大正、昭和、平成、令和..）表示します。
WY	`"WRWYY\"年\"MM\"月\"DD\"日\""`	和暦の年を表示します。Yを記述した数(最大4文字)は表示桁数を示します。
MM	`"YYYY/MM"`	月（1〜12）を表示します。
MONTH	`"MONTH DD YYYY"`	月の名前（JANUARY...）を表示します。9桁で表示されます。
month	`"month DD YYYY"`	キャピタライズされた月の名前（January...）を表示します。9桁で表示されます。
MON	`"dy, DD MON YYYY"`	月の名前の省略形（JAN...）を表示します。
mon	`"dy, DD mon YYYY"`	キャピタライズされた月の名前の省略形（Jan...）を表示します。
DD	`"YY/MM/DD"`	日（1〜31）を表示します。
DAY	`"YY/MM/DD DAY"`	曜日（SUNDAY...）を表示します。
day	`"YY/MM/DD day"`	キャピタライズされた曜日（Sunday...）を表示します。
DY	`"YY/MM/DD DY"`	曜日の省略形（SUN...）を表示します。
dy	`"dy, DD mon YYYY"`	キャピタライズされた曜日の省略形（Sun...）を表示します。
DJ	`"YY/MM/DD DJ"`	曜日のローカル形（月、火...）を表示します。
HH	`"HH:MI:SS"`	12時間制の時（0〜11）を表示します。
HH24	`"HH24:MI:SS"`	24時間制の時（0〜23）を表示します。
HH25～HH47	`"HH28:MI:SS"`	指定の時間制(指定-24～指定-1)を表示します。(HH28の場合、0時～3時は24～27で表示)
MI	`"HH:MI:SS"`	分（0〜59）を表示します。
SS	`"HH:MI:SS"`	秒（0〜59）を表示します。
F	`"HH:MI:SS.F"`	ミリ秒（0〜999）を表示します。
TZ	`"HH24:MI:SS TZ"`	タイムゾーンを +0900の形式で表示します。
u	`"YY/MM/DD uHH24:MI:SS"`	指定箇所より後ろの値をUTC形式で表示します。
-/,.;:	`"HH:MI:SS"`	指定の文字を指定した位置に表示します。
@d	`"@d"`	デフォルトの書式で日付のみを表示します。
@t	`"@t"`	デフォルトの書式で日付と秒なしの時刻を表示します。
@s	`"@s"`	デフォルトの書式で日付と秒付きの時刻を表示します。
@	`"@"`	デフォルトの書式で表示します。@sと同じです。
`"テキスト"`	`"\"時刻は\"HH:MI:SS\"です\""`	`""` で括った文字を指定位置に表示します。 (注: `"` で括ったCRS文字列定数中で `"` を指定するためには `\"` と記述する必要があります。)

WS、WR、WYは和暦が有効な地域でのみ使用可能です。
WS、WR、WYによって和暦の年、年号を利用する場合は、 setLocalCalendar メソッドであらかじめ年号情報を設定する必要があります。明治から令和は自動的に設定されています。

初期値は無指定です。

使用例 CRSダウンロード ダウンロード(neko1.jpg)

Form Label_use {
   x = 0;
   y = 0;
   width = 800;
   height = 600;

       /*
         画像(neko1.jpg)とcrsは同じディレクトリで実行してください
      　 Designerでの実行の場合は画像をプロジェクトに登録します。
        */

   Image Image1 {
           var fs = new FileSystem;
           var file1 = fs.Open("neko1.jpg",FileSystem.OPEN_READ);
        /* LoadImage(file1); */
           LoadImage("neko1.jpg");
   }

   Label obj_Label1[2] {
           x = 32;
           y = 16;
           width = 101;
           height = 22;
           HorizontalAlign =02 ;
           Border = BORDER_SUNKEN;
           this[0].Value = "@\" TEST\"";
           this[1].Value = "\"TEST \"@";
   }
   Label obj_Label2[6] {
           x = 48;
           y = 72;
           width = 100;
           height = 20;
           this[0].Value    = "999,999,990";
           this[1].Value    = ",";
           this[2].Value    = "999,999,999.9";
           this[3].Value    = "999,999,999.00";
           this[4].Value    = ","+".9";
           this[5].Value    = "フォーマットなし";
           Border = BORDER_SUNKEN;
           HorizontalAlign = 2;
   }

   Label:Number obj2[6] {
           x = 168;
           y = 72;
           width = 120;
           height = 20;
           FgColor = "BLACK";
           HorizontalAlign =0;
           Border = BORDER_SUNKEN;
           this[0].Format = "999,999,990";
           this[1].Format = ",";
           this[2].Format = "999,999,999.9";
           this[3].Format = "999,999,999.00";
           this[4].Format = ","+".9";
           this[5].Format = "";
   }

   Button Button2 {
           x = 168;
           y = 32;
           width = 84;
           height = 33;
           Title = "データセット\n12345678.901";

           Function OnTouch( e ) {
                   ^.obj2.Value = "12345678.901";
           }
   }
           Button Button3 {
           x = 264;
           y = 32;
           Width = 83;
           Height = 33;
           title = "Clear";

           Function OnTouch( e ) {
                   ^.obj2.Clear();
           }
   }
   Label Label_resize {
           x = 48;
           y = 216;
           width = 176;
           height = 160;
           Border = BORDER_SUNKEN;
           image = ^.image1;
   }
   Label maruneko {
           x = 240;
           y = 216;
           width = 160;
           height = 120;
           Border = BORDER_SUNKEN;
           resize = RESIZE_FREE ;
           imagewidth &= width;
           imageheight &= height;
           image = ^.image1;
   }
   Label Label5 {
           x = 336;
           y = 136;
           width = 144;
           height = 70;
           value = "ALIGN_STD wordWrap Nekomoni style";
           wordWrap = true;
           Border = BORDER_SUNKEN;
           verticalAlign = DisplayObject.ALIGN_STD;
   }

   Label Label6 {
           x = 328;
           y = 80;
           width = 148;
           Height = 23;
           richText = TRUE ;
           Value = "<a href=\"test.html\">richText プロパティ テスト</a>";
           BgColor = Color.White;
   }
}

format¶

ドキュメント目次

目次