リファレンス: 数値と日付の形式

Visual Studio LightSwitch の数値や日付の表示形式を変更するには、Format Pattern プロパティを設定します。以降のセクションでは、一般的に使用される書式指定文字列の例に加えて、そのプロパティの表記規則を示します。

[!メモ]

この例は、アプリケーションの Culture プロパティが [英語 (米国)] に設定されていることを前提としています。Visual Studio LightSwitch の Culture プロパティを変更すると、カルチャ固有の書式設定は、ローカル コンピューターのカルチャ設定が一致する場合にのみ適用されます。

  1. Numeric Formats

  2. Standard Numeric Format Strings

  3. Custom Numeric Format Strings

  4. Date and Time Formats

  5. Standard Date and Time Format Strings

  6. Custom Date and Time Format Strings

  7. Formatting Guids

数値書式

数値書式指定文字列を使用して書式設定できるデータ型は、Decimal、Double、Integer、Long Integer、および Short Integer です。標準の数値書式指定文字列は、Axx という形式を使用します。A は書式指定子と呼ばれる英文字、xx は精度指定子と呼ばれるオプションの整数です。精度指定子は 0 ~ 99 の範囲で指定され、結果の桁数に影響します。

[!メモ]

Decimal データ型の場合、精度指定子はフィールドに指定されたスケール プロパティ値より大きくすることはできません。Integer、Long Integer、および Short Integer データ型の場合、精度指定子を使用する必要はありません。

また、1 つ以上のカスタム数値指定子で構成されるカスタム数値書式指定文字列を作成して、数値データの書式設定方法を定義することもできます。空白を含む複数の英文字で構成される数値書式指定文字列は、カスタム数値書式指定文字列として解釈されます。

Hh674024.collapse_all(ja-jp,VS.110).gif標準の数値書式指定文字列

次の表に、標準数値書式指定子の一覧と、書式文字列ごとに生成されるサンプル出力を示します。詳細については、「標準の数値書式指定文字列」を参照してください。

書式指定子

名前

生の値、データ型

書式文字列

表示される結果

"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

Hh674024.collapse_all(ja-jp,VS.110).gifカスタム数値書式指定文字列

次の表に、カスタム数値書式指定子の説明と、書式文字列ごとに生成されるサンプル出力を示します。詳細については、「カスタム数値書式指定文字列」を参照してください。

書式指定子

名前

生の値、データ型

書式文字列

表示される結果

"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 °

Hh674024.collapse_all(ja-jp,VS.110).gif日付と時刻の形式

日時書式指定文字列を使用して書式設定できるデータ型は、Date と Date Time です。標準の日時書式指定文字列は、単一の書式指定子を使用して日付と時刻の値のテキスト表現を定義します。空白を含む複数の文字で構成される日時書式指定文字列は、カスタム日時書式指定文字列として解釈されます。

Hh674024.collapse_all(ja-jp,VS.110).gif標準の日時書式指定文字列

標準日時書式指定子を次の表に示します。詳細については、「標準の日付と時刻の書式指定文字列」を参照してください。

書式指定子

説明

生の値 (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

Hh674024.collapse_all(ja-jp,VS.110).gifカスタム日時書式指定文字列

カスタム日時書式指定子を次の表に示します。詳細については、「カスタムの日付と時刻の書式指定文字列」を参照してください。

書式指定子

説明

生の値 (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

Hh674024.collapse_all(ja-jp,VS.110).gifGUID の書式設定

次の表に 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}}

参照

処理手順

方法: 数値と日付を書式設定する

その他の技術情報

データ: アプリケーションの背景情報

型の書式設定