d |
月の日にちを 1 ～ 31 の数値として表します。1 桁の日にちは、先行ゼロなしで書式設定されます。単一のカスタム書式指定子を使用する方法の詳細については、「単一のカスタム書式指定子の使用」を参照してください。
次の例では、複数の書式指定文字列の中に d カスタム書式指定子が含まれます。
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15);
Console.WriteLine(date1.ToString("d, M",
CultureInfo.InvariantCulture));
// Displays 29, 8
Console.WriteLine(date1.ToString("d MMMM",
CultureInfo.CreateSpecificCulture("en-US")));
// Displays 29 August
Console.WriteLine(date1.ToString("d MMMM",
CultureInfo.CreateSpecificCulture("es-MX")));
// Displays 29 agosto
|
dd |
月の日にちを 01 ～ 31 の数値として表します。1 桁の日にちは、先行ゼロ付きで書式設定されます。次の例では、カスタム書式指定文字列の中に dd カスタム書式指定子が含まれます。
|
ddd |
現在の DateTimeFormatInfo.AbbreviatedDayNames プロパティで定義されている曜日の省略名を表します。次の例では、カスタム書式指定文字列の中に ddd カスタム書式指定子が含まれます。
|
dddd (任意の数の d 指定子を追加可能) |
現在の DateTimeFormatInfo.DayNames プロパティで定義されている曜日の完全な名前を表します。次の例では、カスタム書式指定文字列の中に dddd カスタム書式指定子が含まれます。
|
f |
秒の端数の最上位桁 (つまり、日時値の秒部分の 1/10) を表します。
f 書式指定子が単独で使用され、その他の書式指定子がない場合、f は標準の日時書式指定子として解釈されます。単一の書式指定子を使用する方法の詳細については、「単一のカスタム書式指定子の使用」を参照してください。
ParseExact、TryParseExact、ParseExact、TryParseExact のいずれかのメソッドに渡す書式指定文字列の一部として使用された場合、使用された f 書式指定子の数は、文字列を正しく解析するために、秒の端数の最上位桁数が何桁存在している必要があるかを表します。
次の例では、カスタム書式指定文字列の中に f カスタム書式指定子が含まれます。
Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018
|
ff |
秒の端数の最上位 2 桁 (つまり、日時値の秒部分の 1/100) を表します。次の例では、カスタム書式指定文字列の中に ff カスタム書式指定子が含まれます。
Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018
|
fff |
秒の端数の最上位 3 桁 (つまり、日時値の秒部分の 1/1000) を表します。次の例では、カスタム書式指定文字列の中に fff カスタム書式指定子が含まれます。
Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018
|
ffff |
秒の端数の最上位 4 桁 (つまり、日時値の秒部分の 1/10000) を表します。
時刻値の 1/10000 秒要素を表示することもできますが、このような値は意味を持たない場合があります。日付および時刻の値の精度は、システム クロックの分解能に依存します。Windows NT 3.5 以降および Windows Vista オペレーティング システムでは、システム時計の解像力は約 10 ～ 15 ミリ秒です。 |
fffff |
秒の端数の最上位 5 桁 (つまり、日時値の秒部分の 1/100000) を表します。
時刻値の 1/100000 秒要素を表示することもできますが、このような値は意味を持たない場合があります。日付および時刻の値の精度は、システム クロックの分解能に依存します。Windows NT 3.5 以降および Windows Vista オペレーティング システムでは、システム時計の解像力は約 10 ～ 15 ミリ秒です。 |
ffffff |
秒の端数の最上位 6 桁 (つまり、日時値の秒部分の 1/1000000) を表します。
時刻値の 1/1000000 秒要素を表示することもできますが、このような値は意味を持たない場合があります。日付および時刻の値の精度は、システム クロックの分解能に依存します。Windows NT 3.5 以降および Windows Vista オペレーティング システムでは、システム時計の解像力は約 10 ～ 15 ミリ秒です。 |
fffffff |
秒の端数の最上位 7 桁 (つまり、日時値の秒部分の 1/10000000) を表します。
時刻値の 1/10000000 秒要素を表示することもできますが、このような値は意味を持たない場合があります。日付および時刻の値の精度は、システム クロックの分解能に依存します。Windows NT 3.5 以降および Windows Vista オペレーティング システムでは、システム時計の解像力は約 10 ～ 15 ミリ秒です。 |
F |
秒の端数の最上位桁 (つまり、日時値の秒部分の 1/10) を表します。その桁がゼロの場合には、何も表示されません。
F 書式指定子が単独で使用され、その他の書式指定子がない場合、F は標準の日時書式指定子として解釈されます。単一の書式指定子を使用する方法の詳細については、「単一のカスタム書式指定子の使用」を参照してください。
ParseExact、TryParseExact、ParseExact、TryParseExact のいずれかのメソッドの引数として使用された場合、F 書式指定子の数は、秒の端数の最上位桁数が最大何桁あれば、文字列を正しく解析できるかを表します。
次の例では、カスタム書式指定文字列の中に F カスタム書式指定子が含まれます。
Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018
|
FF |
秒の端数の最上位 2 桁 (つまり、日時値の秒部分の 1/100) を表します。ただし、後続のゼロは表示されません。また、2 桁のゼロも表示されません。次の例では、カスタム書式指定文字列の中に FF カスタム書式指定子が含まれます。
Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018
|
FFF |
秒の端数の最上位 3 桁 (つまり、日時値の秒部分の 1/1000) を表します。ただし、後続のゼロは表示されません。また、3 桁のゼロも表示されません。次の例では、カスタム書式指定文字列の中に FFF カスタム書式指定子が含まれます。
Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018
|
FFFF |
秒の端数の最上位 4 桁 (つまり、日時値の秒部分の 1/10000) を表します。ただし、後続のゼロは表示されません。また、4 桁のゼロも表示されません。
時刻値の 1/10000 秒要素を表示することもできますが、このような値は意味を持たない場合があります。日付および時刻の値の精度は、システム クロックの分解能に依存します。Windows NT 3.5 以降および Windows Vista オペレーティング システムでは、システム時計の解像力は約 10 ～ 15 ミリ秒です。 |
FFFFF |
秒の端数の最上位 5 桁 (つまり、日時値の秒部分の 1/100000) を表します。ただし、後続のゼロは表示されません。また、5 桁のゼロも表示されません。
時刻値の 1/100000 秒要素を表示することもできますが、このような値は意味を持たない場合があります。日付および時刻の値の精度は、システム クロックの分解能に依存します。Windows NT 3.5 以降および Windows Vista オペレーティング システムでは、システム時計の解像力は約 10 ～ 15 ミリ秒です。 |
FFFFFF |
秒の端数の最上位 6 桁 (つまり、日時値の秒部分の 1/1000000) を表します。ただし、後続のゼロは表示されません。また、6 桁のゼロも表示されません。
時刻値の 1/1000000 秒要素を表示することもできますが、このような値は意味を持たない場合があります。日付および時刻の値の精度は、システム クロックの分解能に依存します。Windows NT 3.5 以降および Windows Vista オペレーティング システムでは、システム時計の解像力は約 10 ～ 15 ミリ秒です。 |
FFFFFFF |
秒の端数の最上位 7 桁 (つまり、日時値の秒部分の 1/10000000) を表します。ただし、後続のゼロは表示されません。また、7 桁のゼロも表示されません。
時刻値の 1/10000000 秒要素を表示することもできますが、このような値は意味を持たない場合があります。日付および時刻の値の精度は、システム クロックの分解能に依存します。Windows NT 3.5 以降および Windows Vista オペレーティング システムでは、システム時計の解像力は約 10 ～ 15 ミリ秒です。 |
g, gg (任意の数の g 指定子を追加可能) |
年代または紀元を表します (A.D. など)。書式設定される日付に年代または紀元の文字列が関連付けられていない場合、この指定子は無視されます。単一の書式指定子を使用する方法の詳細については、「単一のカスタム書式指定子の使用」を参照してください。
次の例では、カスタム書式指定文字列の中に g カスタム書式指定子が含まれます。
|
h |
時間を 1 ～ 12 の数値として表します。つまり、午前 0 時と午後 0 時から時間をカウントする 12 時間制で時間が表されます。午前 0 時からの特定の時間を、午後 0 時からの同じ時間と区別できません。時間は丸められず、1 桁の時間は先行ゼロなしで書式設定されます。たとえば、5:43 という時間は、このカスタム書式指定子によって "5" と表示されます。単一の書式指定子を使用する方法の詳細については、「単一のカスタム書式指定子の使用」を参照してください。
次の例では、カスタム書式指定文字列の中に h カスタム書式指定子が含まれます。
Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1.5
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1.5
|
hh, hh (任意の数の h 指定子を追加可能) |
時間を 01 ～ 12 の数値として表します。つまり、午前 0 時と午後 0 時から時間をカウントする 12 時間制で時間が表されます。午前 0 時からの特定の時間を、午後 0 時からの同じ時間と区別できません。時間は丸められず、1 桁の時間は先行ゼロ付きで書式設定されます。たとえば、5:43 という時間は、この書式指定子によって "05" と表示されます。
次の例では、カスタム書式指定文字列の中に hh カスタム書式指定子が含まれます。
Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01 du.
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01.50 du.
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01 du.
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01.50 du.
|
H |
時間を 0 ～ 23 の数値として表します。つまり、午前 0 時から時間をカウントする 24 時間制で時間が表されます。1 桁の時間は、先行ゼロなしで書式設定されます。
単一の書式指定子を使用する方法の詳細については、「単一のカスタム書式指定子の使用」を参照してください。
次の例では、カスタム書式指定文字列の中に H カスタム書式指定子が含まれます。
|
HH, HH (任意の数の H 指定子を追加可能) |
時間を 00 ～ 23 の数値として表します。つまり、午前 0 時から時間をカウントする 24 時間制で時間が表されます。1 桁の時間は、先行ゼロ付きで書式設定されます。次の例では、カスタム書式指定文字列の中に HH カスタム書式指定子が含まれます。
|
K |
日付と時刻の値のタイム ゾーン情報を表します。DateTime 値で使用した場合、書式設定後の文字列は、DateTime.Kind プロパティの値によって定義されます。ローカル タイム ゾーンの場合 (DateTime.Kind プロパティ値 = DateTimeKind.Local)、この指定子は zzz 指定子に相当し、書式設定後の文字列には世界協定時刻 (UTC) からのローカル オフセットが含まれます ("-07:00" など)。UTC 時刻の場合 (DateTime.Kind プロパティ値 = DateTimeKind.Utc)、書式設定後の文字列には UTC 日付を表す "Z" 文字が含まれます。タイム ゾーンが指定されていない時刻の場合 (DateTime.Kind プロパティ = DateTimeKind.Unspecified)、String.Empty と同じ結果になります。K 書式指定子を DateTimeOffset 値で使用した場合、この指定子は zz 書式指定子に相当し、書式設定後の文字列には DateTimeOffset 値の UTC を基準としたオフセットが含まれます。
単一の書式指定子を使用する方法の詳細については、「単一のカスタム書式指定子の使用」を参照してください。
次の例では、米国太平洋標準時ゾーンのシステムで、K カスタム書式指定子と各種の DateTime 値および DateTimeOffset 値を組み合わせた結果の文字列を表示します。
Console.WriteLine(Date.Now.ToString("%K"))
' Displays -07:00
Console.WriteLine(Date.UtcNow.ToString("%K"))
' Displays Z
Console.WriteLine("'{0}'", _
Date.SpecifyKind(Date.Now, _
DateTimeKind.Unspecified). _
ToString("%K"))
' Displays ''
Console.WriteLine(DateTimeOffset.Now.ToString("%K"))
' Displays -07:00
Console.WriteLine(DateTimeOffset.UtcNow.ToString("%K"))
' Displays +00:00
Console.WriteLine(New DateTimeOffset(2008, 5, 1, 6, 30, 0, _
New TimeSpan(5, 0, 0)). _
ToString("%K"))
' Displays +05:00
Console.WriteLine(DateTime.Now.ToString("%K"));
// Displays -07:00
Console.WriteLine(DateTime.UtcNow.ToString("%K"));
// Displays Z
Console.WriteLine("'{0}'",
DateTime.SpecifyKind(DateTime.Now,
DateTimeKind.Unspecified).ToString("%K"));
// Displays ''
Console.WriteLine(DateTimeOffset.Now.ToString("%K"));
// Displays -07:00
Console.WriteLine(DateTimeOffset.UtcNow.ToString("%K"));
// Displays +00:00
Console.WriteLine(new DateTimeOffset(2008, 5, 1, 6, 30, 0,
new TimeSpan(5, 0, 0)).ToString("%K"));
// Displays +05:00
|
m |
分を 0 ～ 59 の数値として表します。この分は、直前の時間から経過した分数です。1 桁の分は、先行ゼロなしで書式設定されます。単一の書式指定子を使用する方法の詳細については、「単一のカスタム書式指定子の使用」を参照してください。次の例では、カスタム書式指定文字列の中に m カスタム書式指定子が含まれます。
Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1.5
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1.5
|
mm, mm (任意の数の m 指定子を追加可能) |
分を 00 ～ 59 の数値として表します。この分は、直前の時間から経過した分数です。1 桁の分は、先行ゼロ付きで書式設定されます。次の例では、カスタム書式指定文字列の中に mm カスタム書式指定子が含まれます。
Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01 du.
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01.50 du.
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01 du.
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01.50 du.
|
M |
月を 1 ～ 12 の数値として表します。1 桁の月は、先行ゼロなしで書式設定されます。単一の書式指定子を使用する方法の詳細については、「単一のカスタム書式指定子の使用」を参照してください。次の例では、カスタム書式指定文字列の中に M カスタム書式指定子が含まれます。
DateTime date1 = new DateTime(2008, 8, 18);
Console.WriteLine(date1.ToString("(M) MMM, MMMM",
CultureInfo.CreateSpecificCulture("en-US")));
// Displays (8) Aug, August
Console.WriteLine(date1.ToString("(M) MMM, MMMM",
CultureInfo.CreateSpecificCulture("nl-NL")));
// Displays (8) aug, augustus
Console.WriteLine(date1.ToString("(M) MMM, MMMM",
CultureInfo.CreateSpecificCulture("lv-LV")));
// Displays (8) Aug, augusts
|
MM |
月を 01 ～ 12 の数値として表します。1 桁の月は、先行ゼロ付きで書式設定されます。次の例では、カスタム書式指定文字列の中に MM カスタム書式指定子が含まれます。
|
MMM |
現在の DateTimeFormatInfo.AbbreviatedMonthNames プロパティで定義されている月の省略名を表します。次の例では、カスタム書式指定文字列の中に MMM カスタム書式指定子が含まれます。
|
MMMM |
現在の DateTimeFormatInfo.MonthNames プロパティで定義されている月の完全な名前を表します。次の例では、カスタム書式指定文字列の中に MMMM カスタム書式指定子が含まれます。
|
s |
秒を 0 ～ 59 の数値として表します。この秒は、直前の分から経過した秒数です。1 桁の秒は、先行ゼロなしで書式設定されます。単一の書式指定子を使用する方法の詳細については、「単一のカスタム書式指定子の使用」を参照してください。次の例では、カスタム書式指定文字列の中に s カスタム書式指定子が含まれます。
Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1.5
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1.5
|
ss, ss (任意の数の s 指定子を追加可能) |
秒を 00 ～ 59 の数値として表します。この秒は、直前の分から経過した秒数です。1 桁の秒は、先行ゼロ付きで書式設定されます。次の例では、カスタム書式指定文字列の中に ss カスタム書式指定子が含まれます。
Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01 du.
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01.50 du.
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01 du.
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01.50 du.
|
t |
現在の DateTimeFormatInfo.AMDesignator プロパティまたは DateTimeFormatInfo.PMDesignator プロパティで定義されている AM/PM 指定子の最初の文字を表します。AM 指定子は、書式設定される時刻の時間が 12 未満である場合に使用され、それ以外の場合は PM 指定子が使用されます。単一の書式指定子を使用する方法の詳細については、「単一のカスタム書式指定子の使用」を参照してください。
次の例では、カスタム書式指定文字列の中に t カスタム書式指定子が含まれます。
Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1.5
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1.5
|
tt, tt (任意の数の t 指定子を追加可能) |
現在の DateTimeFormatInfo.AMDesignator プロパティまたは DateTimeFormatInfo.PMDesignator プロパティで定義されている AM/PM 指定子を表します。AM 指定子は、書式設定される時刻の時間が 12 未満である場合に使用され、それ以外の場合は PM 指定子が使用されます。
AM と PM を区別する必要のある言語の場合、アプリケーションで必ず tt 指定子を使用する必要があります。たとえば、日本語の場合、AM/PM 指定子の 2 番目の文字は異なりますが、先頭文字は同じです。
次の例では、カスタム書式指定文字列の中に tt カスタム書式指定子が含まれます。
Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01 du.
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01.50 du.
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss.FF tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01 du.
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01.50 du.
|
y |
年を 1 桁または 2 桁の数値として表します。年が 2 桁を超える場合は、下 2 桁のみが結果に表示されます。2 桁の年の 1 桁目がゼロで始まる場合 (2008 など)、先行ゼロが省略されます。単一の書式指定子を使用する方法の詳細については、「単一のカスタム書式指定子の使用」を参照してください。
次の例では、カスタム書式指定文字列の中に y カスタム書式指定子が含まれます。
|
yy |
年を 2 桁の数値として表します。年が 2 桁を超える場合は、下 2 桁のみが結果に表示されます。年が 2 桁に満たない場合は、2 桁になるまで数値が先行ゼロで埋められます。
次の例では、カスタム書式指定文字列の中に yy カスタム書式指定子が含まれます。
|
yyy |
年を 3 桁以上で表します。年が 3 桁を超える場合は、それらの数字も結果に含まれます。年が 3 桁に満たない場合は、3 桁になるまで数値が先行ゼロで埋められます。
年が 5 桁になることがあるタイ仏暦については、この書式指定子で 5 桁すべてが表示されるので注意してください。
次の例では、カスタム書式指定文字列の中に yyy カスタム書式指定子が含まれます。
|
yyyy |
年を 4 桁の数値として表します。年が 4 桁を超える場合は、下 4 桁のみが結果に表示されます。年が 4 桁に満たない場合は、4 桁になるまで数値が先行ゼロで埋められます。
年が 5 桁になることがあるタイ仏暦については、この書式指定子で 5 桁すべてが含まれるので注意してください。
次の例では、カスタム書式指定文字列の中に yyyy カスタム書式指定子が含まれます。
|
yyyyy (任意の数の y 指定子を追加可能) |
年を 5 桁の数値として表します。年が 5 桁を超える場合は、下 5 桁のみが結果に表示されます。年が 5 桁に満たない場合は、5 桁になるまで数値が先行ゼロで埋められます。
y 指定子を追加すると、y 指定子の数と同じ桁数になるまで数値が先行ゼロで埋められます。
次の例では、カスタム書式指定文字列の中に yyyyy カスタム書式指定子が含まれます。
|
z |
DateTime 値で使用した場合、オペレーティング システムのローカル タイム ゾーンの、世界協定時刻 (UTC) を基準とした符号付きオフセット (時間単位) を表します。インスタンスの Kind プロパティの値は反映されません。そのため、DateTime 値に対して z 書式指定子を使用することはお勧めできません。
DateTimeOffset 値で使用した場合、DateTimeOffset 値の、UTC を基準とするオフセット (時間単位) を表します。
このオフセットは、常に先頭の符号と共に表示されます。正符号 (+) は UTC より時間が進んでいることを示し、負符号 (-) は UTC より時間が遅れていることを示します。オフセットの範囲は –12 ～ +13 です。1 桁のオフセットは、先行ゼロなしで書式設定されます。単一の書式指定子を使用する方法の詳細については、「単一のカスタム書式指定子の使用」を参照してください。次の例では、カスタム書式指定文字列の中に z カスタム書式指定子が含まれます。
Dim date1 As Date = Date.UtcNow
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date1))
' Displays -7, -07, -07:00
Dim date2 As New DateTimeOffset(2008, 8, 1, 0, 0, 0, _
New Timespan(6, 0, 0))
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date2))
' Displays +6, +06, +06:00
DateTime date1 = DateTime.UtcNow;
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date1));
// Displays -7, -07, -07:00
DateTimeOffset date2 = new DateTimeOffset(2008, 8, 1, 0, 0, 0,
new TimeSpan(6, 0, 0));
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date2));
// Displays +6, +06, +06:00
|
zz |
DateTime 値で使用した場合、オペレーティング システムのローカル タイム ゾーンの、UTC を基準とした符号付きオフセット (時間単位) を表します。インスタンスの Kind プロパティの値は反映されません。そのため、DateTime 値に対して zz 書式指定子を使用することはお勧めできません。
DateTimeOffset 値で使用した場合、DateTimeOffset 値の、UTC を基準とするオフセット (時間単位) を表します。
このオフセットは、常に先頭の符号と共に表示されます。正符号 (+) は UTC より時間が進んでいることを示し、負符号 (-) は UTC より時間が遅れていることを示します。オフセットの範囲は、-12 ～ +13 です。1 桁のオフセットは、先行ゼロ付きで書式設定されます。次の例では、カスタム書式指定文字列の中に zz カスタム書式指定子が含まれます。
Dim date1 As Date = Date.UtcNow
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date1))
' Displays -7, -07, -07:00
Dim date2 As New DateTimeOffset(2008, 8, 1, 0, 0, 0, _
New Timespan(6, 0, 0))
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date2))
' Displays +6, +06, +06:00
DateTime date1 = DateTime.UtcNow;
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date1));
// Displays -7, -07, -07:00
DateTimeOffset date2 = new DateTimeOffset(2008, 8, 1, 0, 0, 0,
new TimeSpan(6, 0, 0));
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date2));
// Displays +6, +06, +06:00
|
zzz, zzz (任意の数の z 指定子を追加可能) |
DateTime 値で使用した場合、オペレーティング システムのローカル タイム ゾーンの、UTC を基準とした符号付きオフセット (時間および分単位) を表します。インスタンスの Kind プロパティの値は反映されません。そのため、DateTime 値に対して zzz 書式指定子を使用することはお勧めできません。
DateTimeOffset 値で使用した場合、DateTimeOffset 値の、UTC を基準とするオフセット (時間および分単位) を表します。
このオフセットは、常に先頭の符号と共に表示されます。正符号 (+) は UTC より時間が進んでいることを示し、負符号 (-) は UTC より時間が遅れていることを示します。オフセットの範囲は、-12 ～ +13 です。1 桁のオフセットは、先行ゼロ付きで書式設定されます。次の例では、カスタム書式指定文字列の中に zzz カスタム書式指定子が含まれます。
Dim date1 As Date = Date.UtcNow
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date1))
' Displays -7, -07, -07:00
Dim date2 As New DateTimeOffset(2008, 8, 1, 0, 0, 0, _
New Timespan(6, 0, 0))
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date2))
' Displays +6, +06, +06:00
DateTime date1 = DateTime.UtcNow;
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date1));
// Displays -7, -07, -07:00
DateTimeOffset date2 = new DateTimeOffset(2008, 8, 1, 0, 0, 0,
new TimeSpan(6, 0, 0));
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date2));
// Displays +6, +06, +06:00
|
: |
現在の DateTimeFormatInfo.TimeSeparator プロパティで定義されている時刻の区切り記号を表します。この区切り記号は、時、分、および秒を区別するために使用されます。 |
/ |
現在の DateTimeFormatInfo.DateSeparator プロパティで定義されている日付の区切り記号を表します。この区切り記号は、年、月、および日を区別するために使用されます。 |
" |
引用文字列 (引用符) を表します。2 つの二重引用符 (") で囲まれた文字列のリテラル値が表示されます。各引用符の前にはエスケープ文字 (\) が必要です。 |
' |
引用文字列 (アポストロフィ) を表します。2 つのアポストロフィ (') 文字で囲まれた文字列のリテラル値が表示されます。 |
%c |
カスタム日時書式指定文字列が c カスタム書式指定子だけで構成されている場合に、そのカスタム書式指定子に関連付けられた結果を表します。つまり、d、f、F、h、m、s、t、y、z、H、M の各カスタム書式指定子を単独で使用するには、それぞれ "%d"、"%f"、"%F"、"%h"、"%m"、"%s"、"%t"、"%y"、"%z"、"%H"、"%M" と指定します。単一の書式指定子を使用する方法の詳細については、「単一のカスタム書式指定子の使用」を参照してください。 |
\c |
エスケープ文字を表します。"c" の文字の前にエスケープ文字 (\) を付けると、その文字がリテラルとして表示されます。結果の文字列に円記号そのものを挿入する場合は、2 つのエスケープ文字 ("\\") を使用します。 |
その他の文字 |
その他の文字は結果の文字列にコピーされ、書式設定には影響しません。 |