Visual Studio LightSwitch の数値や日付の表示形式を変更するには、Format Pattern プロパティを設定します。以降のセクションでは、一般的に使用される書式指定文字列の例に加えて、そのプロパティの表記規則を示します。
[!メモ]
この例は、アプリケーションの Culture プロパティが [英語 (米国)] に設定されていることを前提としています。Visual Studio LightSwitch の Culture プロパティを変更すると、カルチャ固有の書式設定は、ローカル コンピューターのカルチャ設定が一致する場合にのみ適用されます。
数値書式
数値書式指定文字列を使用して書式設定できるデータ型は、Decimal、Double、Integer、Long Integer、および Short Integer です。標準の数値書式指定文字列は、Axx という形式を使用します。A は書式指定子と呼ばれる英文字、xx は精度指定子と呼ばれるオプションの整数です。精度指定子は 0 ~ 99 の範囲で指定され、結果の桁数に影響します。
[!メモ]
Decimal データ型の場合、精度指定子はフィールドに指定されたスケール プロパティ値より大きくすることはできません。Integer、Long Integer、および Short Integer データ型の場合、精度指定子を使用する必要はありません。
また、1 つ以上のカスタム数値指定子で構成されるカスタム数値書式指定文字列を作成して、数値データの書式設定方法を定義することもできます。空白を含む複数の英文字で構成される数値書式指定文字列は、カスタム数値書式指定文字列として解釈されます。
標準の数値書式指定文字列
次の表に、標準数値書式指定子の一覧と、書式文字列ごとに生成されるサンプル出力を示します。詳細については、「標準の数値書式指定文字列」を参照してください。
書式指定子 |
名前 |
生の値、データ型 |
書式文字列 |
表示される結果 |
|---|---|---|---|---|
"C" または "c" |
通貨 |
123.456, Double 123.456, Double 123.456, Double 123, Integer |
C C2 C3 C |
$123.46 $123.46 $123.456 $123.00 |
"D" または "d" |
Decimal (10 進数型) |
1234, Integer 1234, Short Integer -1234, Long Integer |
D D6 D6 |
1234 001234 -001234 |
"E" または "e" |
指数 |
1052.0329112756, Double -1052.0329112756, Double |
E E2 |
1.052033E+003 -1.05e+003 |
"F" または "f" |
固定小数点 |
1234.567, Double 1234, Decimal -1234.56, Double |
F F1 F4 |
1234.57 1234.0 -1234.5600 |
"G" または "g" |
一般 |
-123.456, Double 123.4546, Double -1.234567890e-25、Double |
G G4 G |
-123.456 123.5 --1.23456789E-25 |
"N" または "n" |
Number |
1234.567, Double 1234, Integer -1234.56, Double |
N N N |
1,234.57 1,234.0 -1,234.560 |
"P" または "p" |
パーセント |
1, Double -0.39678, Double |
P P1 |
100.00 % -39.7 % |
"R" または "r" |
ラウンドトリップ |
123456789.12345678, Double -1234567890.12345678, Double |
R R |
123456789.12345678 -1234567890.1234567 |
"X" または "x" |
16 進数 |
255, Integer -1, Integer 255, Integer -1, Integer |
x x X4 X4 |
FF ff 00ff -00FF |
カスタム数値書式指定文字列
次の表に、カスタム数値書式指定子の説明と、書式文字列ごとに生成されるサンプル出力を示します。詳細については、「カスタム数値書式指定文字列」を参照してください。
書式指定子 |
名前 |
生の値、データ型 |
書式文字列 |
表示される結果 |
|---|---|---|---|---|
"0" |
ゼロ プレースホルダー |
1234.5678, Double 0.45678, Double |
00000 0.00 |
01235 0.46 |
"#" |
桁プレースホルダー |
1234.5678, Double 0.45678, Double |
##### #.## |
1235 .46 |
"." |
小数点 |
0.45678, Double |
0.00 |
0.46 |
"," |
桁区切り記号および数値の位取り |
2147483647, Integer 2147483647, Integer |
##,# #,#,, |
2,147,483,647 2,147 |
"%" |
パーセント プレースホルダー |
0.3697, Double 0.3697, Double |
%#0.00 ##.0 % |
%36.97 37.0 % |
"‰" |
パーミル プレースホルダー |
0.03697, Double |
#0.00‰ |
36.97‰ |
"E0" "E+0" "E-0" "e0" "e+0" "e-0" |
指数表記 |
987654, Double 1503.92311, Double 1.8901385E-16 ("0.0e+00")、Double |
#0.0e0 0.0##e+00 0.0e+00 |
98.8e4 1.504e+03 1.9e-16 |
\ |
エスケープ文字 |
987654, Integer |
\###00\# |
#987654# |
'string' "string" |
リテラル文字列区切り記号 |
68, Integer 68, Integer |
# ' degrees' #” degrees” |
68 degrees 68 degrees |
; |
セクション区切り記号 |
12.345, Double 0, Double -12.345, Double 12.345, Double 0, Double -12.345, Double |
#0.0#;(#0.0#);-\0- #0.0#;(#0.0#);-\0- #0.0#;(#0.0#);-\0- #0.0#;(#0.0#) #0.0#;(#0.0#) #0.0#;(#0.0#) |
12.35 -0- (12.35) 12.35 0.0 (12.35) |
その他 |
上記以外のすべての文字 |
68, Integer |
# ° |
68 ° |
日付と時刻の形式
日時書式指定文字列を使用して書式設定できるデータ型は、Date と Date Time です。標準の日時書式指定文字列は、単一の書式指定子を使用して日付と時刻の値のテキスト表現を定義します。空白を含む複数の文字で構成される日時書式指定文字列は、カスタム日時書式指定文字列として解釈されます。
標準の日時書式指定文字列
標準日時書式指定子を次の表に示します。詳細については、「標準の日付と時刻の書式指定文字列」を参照してください。
書式指定子 |
説明 |
生の値 (Date Time) |
書式文字列 |
表示される結果 |
|---|---|---|---|---|
"d" |
短い形式の日付パターン。 |
6/15/2009 1:45:30 PM |
d |
6/15/2009 |
"D" |
長い形式の日付パターン。 |
6/15/2009 1:45:30 PM |
D |
Monday, June 15, 2009 |
"f" |
完全な日付と時刻のパターン (短い形式の時刻)。 |
6/15/2009 1:45:30 PM |
f |
Monday, June 15, 2009 1:45 PM |
"F" |
完全な日付と時刻のパターン (長い形式の時刻)。 |
6/15/2009 1:45:30 PM |
F |
Monday, June 15, 2009 1:45:30 PM |
"g" |
一般の日付と時刻のパターン (短い形式の時刻)。 |
6/15/2009 1:45:30 PM |
g |
6/15/2009 1:45 PM |
"G" |
一般の日付と時刻のパターン (長い形式の時刻)。 |
6/15/2009 1:45:30 PM |
G |
6/15/2009 1:45:30 PM |
"M"、"m" |
月日パターン。 |
6/15/2009 1:45:30 PM |
M |
June 15 |
"O"、"o" |
ラウンドトリップする日付と時刻のパターン。 |
6/15/2009 1:45:30 PM |
O |
2009-06-15T13:45:30.0900000 |
"R"、"r" |
RFC1123 パターン。 |
6/15/2009 1:45:30 PM |
R |
Mon, 15 Jun 2009 20:45:30 GMT |
"s" |
並べ替え可能な日付と時刻のパターン。 |
6/15/2009 1:45:30 PM |
s |
62009-06-15T13:45:30 |
"t" |
短い形式の時刻パターン。 |
6/15/2009 1:45:30 PM |
t |
1:45 PM |
"T" |
長い形式の時刻パターン。 |
6/15/2009 1:45:30 PM |
T |
1:45:30 PM |
"u" |
並べ替え可能な日付と時刻のパターン (世界時刻)。 |
6/15/2009 1:45:30 PM |
u |
6/15/2009 1:45:30 PM -> 2009-06-15 20:45:30Z |
"U" |
完全な日付と時刻のパターン (世界時刻)。 |
6/15/2009 1:45:30 PM |
U |
Monday, June 15, 2009 8:45:30 PM |
"Y"、"y" |
年月パターン。 |
6/15/2009 1:45:30 PM |
Y |
June, 2009 |
カスタム日時書式指定文字列
カスタム日時書式指定子を次の表に示します。詳細については、「カスタムの日付と時刻の書式指定文字列」を参照してください。
書式指定子 |
説明 |
生の値 (Date Time) |
書式文字列 |
表示される結果 |
|---|---|---|---|---|
"d" |
月の日にち (1 ~ 31)。 |
6/1/2009 1:45:30 PM 6/15/2009 1:45:30 PM |
d d |
1 15 |
"dd" |
月の日にち (01 ~ 31)。 |
6/1/2009 1:45:30 PM 6/15/2009 1:45:30 PM |
dd dd |
01 15 |
"ddd" |
曜日の省略名。 |
6/15/2009 1:45:30 PM |
ddd |
Mon |
"dddd" |
曜日の完全名。 |
6/15/2009 1:45:30 PM |
dddd |
月曜日 |
"f" |
日時値の秒部分の 1/10。 |
6/15/2009 13:45:30.617 6/15/2009 13:45:30.050 |
f f |
6 0 |
"ff" |
日時値の秒部分の 1/100。 |
6/15/2009 13:45:30.617 6/15/2009 13:45:30.005 |
ff ff |
61 00 |
"fff" |
日時値の秒部分の 1/1000。 |
6/15/2009 13:45:30.617 6/15/2009 13:45:30.0005 |
fff fff |
617 000 |
"ffff" |
日時値の秒部分の 1/10000。 |
6/15/2009 13:45:30.6175 6/15/2009 13:45:30.00005 |
ffff ffff |
6175 0000 |
"fffff" |
日時値の秒部分の 1/100000。 |
6/15/2009 13:45:30.61754 6/15/2009 13:45:30.000005 |
fffff fffff |
61754 00000 |
"ffffff" |
日時値の秒部分の 1/1000000。 |
6/15/2009 13:45:30.617542 6/15/2009 13:45:30.0000005 |
ffffff ffffff |
617542 000000 |
"fffffff" |
日時値の秒部分の 1/10000000。 |
6/15/2009 13:45:30.6175425 6/15/2009 13:45:30.0001150 |
fffffff fffffff |
6175425 0001150 |
"F" |
日時値の秒部分の 1/10 (0 以外の場合)。 |
6/15/2009 13:45:30.617 6/15/2009 13:45:30.050 |
F F |
6 (出力なし) |
"FF" |
日時値の秒部分の 1/100 (0 以外の場合)。 |
6/15/2009 13:45:30.617 6/15/2009 13:45:30.005 |
FF FF |
61 (出力なし) |
"FFF" |
日時値の秒部分の 1/1000 (0 以外の場合)。 |
6/15/2009 13:45:30.617 6/15/2009 13:45:30.0005 |
FFF FFF |
617 (出力なし) |
"FFFF" |
日時値の秒部分の 1/10000 (0 以外の場合)。 |
6/1/2009 13:45:30.5275 6/15/2009 13:45:30.00005 |
FFFF FFFF |
5275 (出力なし) |
"FFFFF" |
日時値の秒部分の 1/100000 (0 以外の場合)。 |
6/15/2009 13:45:30.61754 6/15/2009 13:45:30.000005 |
FFFFF FFFFF |
61754 (出力なし) |
"FFFFFF" |
日時値の秒部分の 1/1000000 (0 以外の場合)。 |
6/15/2009 13:45:30.617542 6/15/2009 13:45:30.0000005 |
FFFFFF FFFFFF |
617542 (出力なし) |
"FFFFFFF" |
日時値の秒部分の 1/10000000 (0 以外の場合)。 |
6/15/2009 13:45:30.6175425 6/15/2009 13:45:30.0001150 |
FFFFFFF FFFFFFF |
6175425 000115 |
"g"、"gg" |
時期または時代 (年号)。 |
6/15/2009 1:45:30 PM |
g |
A.D. |
"h" |
12 時間形式の時間 (1 ~ 12)。 |
6/15/2009 1:45:30 AM 6/15/2009 1:45:30 PM |
h h |
1 1 |
"hh" |
12 時間形式の時間 (01 ~ 12)。 |
6/15/2009 1:45:30 AM 6/15/2009 1:45:30 PM |
hh hh |
01 01 |
"H" |
24 時間形式の時間 (0 ~ 23)。 |
6/15/2009 1:45:30 AM 6/15/2009 1:45:30 PM |
H H |
1 13 |
"HH" |
24 時間形式の時間 (00 ~ 23)。 |
6/15/2009 1:45:30 AM 6/15/2009 1:45:30 PM |
HH HH |
01 13 |
"m" |
分 (0 ~ 59)。 |
6/15/2009 1:09:30 AM 6/15/2009 1:29:30 PM |
m m |
9 29 |
"mm" |
分 (00 ~ 59)。 |
6/15/2009 1:09:30 AM 6/15/2009 1:29:30 PM |
mm mm |
09 29 |
"M" |
月 (1 ~ 12)。 |
6/15/2009 1:45:30 PM |
M |
6 |
"MM" |
月 (01 ~ 12)。 |
6/15/2009 1:45:30 PM |
MM |
06 |
"MMM" |
月の省略名。 |
6/15/2009 1:45:30 PM |
MMM |
Jun |
"MMMM" |
月の完全名。 |
6/15/2009 1:45:30 PM |
MMMM |
June |
"s" |
秒 (0 ~ 59)。 |
6/15/2009 1:45:09 PM |
s |
9 |
"ss" |
秒 (00 ~ 59)。 |
6/15/2009 1:45:09 PM |
ss |
09 |
"t" |
AM/PM 指定子の最初の文字。 |
6/15/2009 1:45:30 PM |
t |
P |
"tt" |
AM/PM 指定子。 |
6/15/2009 1:45:30 PM |
tt |
PM |
"y" |
年 (0 ~ 99)。 |
6/15/2009 1:45:30 PM |
y |
9 |
"yy" |
年 (00 ~ 99)。 |
6/15/2009 1:45:30 PM |
yy |
09 |
"yyy" |
年 (3 桁以上)。 |
1/1/0001 12:00:00 AM 6/15/2009 1:45:30 PM |
yyy yyy |
001 2009 |
"yyyy" |
年 (4 桁の数値)。 |
6/15/2009 1:45:30 PM |
yyyy |
2009 |
"yyyyy" |
年 (5 桁の数値)。 |
6/15/2009 1:45:30 PM |
yyyyy |
02009 |
"z" |
UTC を基準とする時間単位のオフセット (先行ゼロなし)。 |
6/15/2009 1:45:30 PM -07:00 |
z |
-7 |
"zz" |
UTC を基準とする時間単位のオフセット (先行ゼロ付きの 1 桁の値)。 |
6/15/2009 1:45:30 PM -07:00 |
zz |
-07 |
"zzz" |
UTC を基準とする時間および分単位のオフセット。 |
6/15/2009 1:45:30 PM -07:00 |
zzz |
-07:00 |
":" |
時刻の区切り記号。 |
6/15/2009 1:45:30 PM |
hh:mm |
01:45 |
"/" |
日付の区切り記号。 |
6/15/2009 1:45:30 PM |
MM/dd |
6/15 |
"string" 'string' |
リテラル文字列の区切り記号。 |
6/15/2009 1:45:30 PM 6/15/2009 1:45:30 PM |
"arr:" h:m t 'arr:' h:m t |
arr: 1:45 P arr: 1:45 P |
% |
後続の文字をカスタム書式指定子として定義します。 |
6/15/2009 1:45:30 PM |
%h |
1 |
\ |
エスケープ文字。 |
6/15/2009 1:45:30 PM |
h \h |
1 h |
その他の文字 |
文字が結果の文字列にそのままコピーされます。 |
6/15/2009 1:45:30 AM |
arr hh:mm t |
arr 01:45 A |
GUID の書式設定
次の表に GUID データ型の書式指定子を示します。
書式 |
説明 |
生の値 (Guid) |
書式文字列 |
表示される結果 |
|---|---|---|---|---|
N |
32 文字を表示します。 |
3261a3cfc18f4747b957e5264b6a430c |
N |
3261a3cfc18f4747b957e5264b6a430c |
D |
32 文字をハイフンで区切って表示します。 |
3261a3cfc18f4747b957e5264b6a430c |
D |
3261a3cf-c18f-4747-b957-e5264b6a430c |
B |
ハイフンで区切られた 32 文字を中かっこで囲んで表示します。 |
3261a3cfc18f4747b957e5264b6a430c |
B |
{3261a3cf-c18f-4747-b957-e5264b6a430c } |
P |
ハイフンで区切られた 32 文字をかっこで囲んで表示します。 |
3261a3cfc18f4747b957e5264b6a430c |
P |
(3261a3cf-c18f-4747-b957-e5264b6a430c) |
x |
中かっこで囲まれている 4 つの 16 進値。ここで 4 番目の値は 8 つの 16 進値のサブセットで、別の中かっこで囲まれています。 |
3261a3cfc18f4747b957e5264b6a430c |
x |
{0x3261a3cf,0xc18f,0x4747,{0xb0,0x57,0xe5,0x26,0x4b,0x6a,0x43,0x0c}} |