FORMAT 関数のカスタム日付/時刻書式
次の表は、ユーザー定義の日付/時刻書式の作成に使用できる文字を示しています。
書式指定 |
説明 |
|---|---|
(:) |
時刻の区切り記号。 ロケールによっては、時刻の区切り記号を表すために他の文字が使用されます。 時刻の区切り記号は、時刻値の書式設定時に、時、分、および秒を区切ります。 書式設定された出力で実際に時刻の区切り記号として使用される文字は、アプリケーションの現在のカルチャ値によって決まります。 |
(/) |
日付の区切り記号。 ロケールによっては、日付の区切り記号を表すために他の文字が使用されます。 日付の区切り記号は、日付値の書式設定時に、日、月、および年を区切ります。 書式設定された出力で実際に日付の区切り記号として使用される文字は、アプリケーションの現在のカルチャによって決まります。 |
(%) |
後続の文字にかかわらず、次の文字を 1 文字書式として読み取ることを示すために使用します。 また、ユーザー定義の書式として 1 文字書式を読み取ることも示します。 詳細については、以下の説明を参照してください。 |
d |
前に 0 を付けない数値で日を表示します (1 など)。 ユーザー定義の数値書式がこの文字のみの場合は、%d を使用します。 |
dd |
前に 0 を付けた数値で日を表示します (01 など)。 |
ddd |
曜日を省略形で表示します (Sun など)。 |
dddd |
曜日を完全な名前で表示します (Sunday など)。 |
M |
前に 0 を付けない数値で月を表示します (たとえば 1 月を 1 と表示)。 ユーザー定義の数値書式がこの文字のみの場合は、%M を使用します。 |
MM |
前に 0 を付けた数値で月を表示します (01/12/01 など)。 |
MMM |
月を省略形で表示します (Jan など)。 |
MMMM |
月を完全な月名で表示します (January など)。 |
gg |
時代または年号を表す文字列を表示します (A.D. など)。 |
h |
12 時間制を使用して、前に 0 を付けない数値で時間を表示します (1:15:15 PM など)。 ユーザー定義の数値書式がこの文字のみの場合は、%h を使用します。 |
hh |
12 時間制を使用して、前に 0 を付けた数値で時間を表示します (01:15:15 PM など)。 |
H |
24 時間制を使用して、前に 0 を付けない数値で時間を表示します (1:15:15 など)。 ユーザー定義の数値書式がこの文字のみの場合は、%H を使用します。 |
HH |
24 時間制を使用して、前に 0 を付けた数値で時間を表示します (01:15:15 など)。 |
m |
前に 0 を付けない数値で分を表示します (12:1:15 など)。 ユーザー定義の数値書式がこの文字のみの場合は、%m を使用します。 |
mm |
前に 0 を付けた数値で分を表示します (12:01:15 など)。 |
s |
前に 0 を付けない数値で秒を表示します (12:15:5 など)。 ユーザー定義の数値書式がこの文字のみの場合は、%s を使用します。 |
ss |
前に 0 を付けた数値で秒を表示します (12:15:05 など)。 |
f |
秒の小数部を表示します。 たとえば、ff は 100 分の 1 秒を表示し、ffff は 1 万分の 1 秒を表示します。 ユーザー定義の書式では f 記号を 7 個まで使用できます。 ユーザー定義の数値書式がこの文字のみの場合は、%f を使用します。 |
t |
12 時間制を使用して、正午より前の時間には大文字の A を表示し、正午から午後 11 時 59 分までの時間には大文字の P を表示します。 ユーザー定義の数値書式がこの文字のみの場合は、%t を使用します。 |
tt |
12 時間制を使用するロケールで、正午より前の時間には大文字の AM を表示し、正午から午後 11 時 59 分までの時間には大文字の PM を表示します。 24 時間制を使用するロケールの場合は、何も表示されません。 |
y |
前に 0 を付けずに年を表示します (0 ～ 9)。 ユーザー定義の数値書式がこの文字のみの場合は、%y を使用します。 |
yy |
前に 0 を付けた 2 桁の数値書式で年を表示します (該当する場合)。 |
yyy |
4 桁の数値書式で年を表示します。 |
yyyy |
4 桁の数値書式で年を表示します。 |
z |
前に 0 を付けずにタイムゾーン オフセットを表示します (-8 など)。 ユーザー定義の数値書式がこの文字のみの場合は、%z を使用します。 |
zz |
前に 0 を付けてタイムゾーン オフセットを表示します (-08 など)。 |
zzz |
完全なタイムゾーン オフセットを表示します (-08:00 など)。 |
説明
書式設定文字列では大文字と小文字が区別されます。 使用するのが大文字か小文字かによって、異なる書式設定となります。 たとえば、文字列 "D" を使用して日付値を書式設定する場合、現在のロケールに応じて長い書式の日付が取得されますが、 文字列を小文字の "d" に変更すると、短い書式の日付が取得されます。 さらに、意図した書式設定が、定義された書式文字列の大文字小文字と一致しない場合は、予期しない結果またはエラーが発生することがあります。
日付/時刻書式設定では、現在のユーザー ロケールを使用して、最終的な文字列の書式が決まります。 たとえば、書式文字列 "M/d/yyyy" を使用して日付 1995 年 3 月 18 日を書式設定すると、ユーザー ロケールがアメリカ合衆国 (en-us) に設定されている場合、結果は "3/18/1995" になりますが、ドイツ (de-de) に設定されている場合は "18.03.1995" になります。