標準の日時書式指定文字列

[アーティクル]
03/22/2025

標準の日時書式指定文字列では、書式指定子として 1 文字を使用して、DateTime または DateTimeOffset 値のテキスト表現を定義します。空白を含む複数の文字で構成される日時書式指定文字列は、カスタム日時書式指定文字列として解釈されます。標準書式指定文字列またはカスタム書式指定文字列は、次の 2 つの方法で使用できます。

書式設定操作の結果の文字列を定義します。
解析操作によって DateTime または DateTimeOffset 値に変換できる日付と時刻の値のテキスト表現を定義します。

ヒント

書式設定ユーティリティをダウンロードできます。.NET Windows フォームアプリケーションでは、数値または日付と時刻の値に書式指定文字列を適用し、結果文字列を表示できます。ソースコードは、C# および Visual Basic で使用できます。

注

この記事の C# の例の一部は、Try.NET インラインコードランナーとプレイグラウンドで実行されます。 [実行] ボタンを選択すると、対話型ウィンドウで例が実行されます。コードを実行したら、コードを変更し、[実行] をもう一度選択して変更後のコードを実行できます。変更後のコードが対話型ウィンドウで実行されるか、コンパイルできなかった場合、対話型ウィンドウにすべての C# コンパイラエラーメッセージが表示されます。

Try.NET インラインコードランナーとプレイグラウンドのローカルタイムゾーンは、協定世界時 (UTC) です。これは、DateTime、DateTimeOffset、および TimeZoneInfo 型とそのメンバーを示す例の動作と出力に影響する可能性があります。

書式指定子の表

標準日時書式指定子を次の表に示します。特に明記されていない限り、特定の標準日時書式指定子は、DateTime 値と DateTimeOffset 値のどちらで使用されるかに関係なく、同一の文字列表現を生成します。標準日付と時刻の書式指定文字列の使用に関する詳細については、「コントロールパネルの設定と DateTimeFormatInfo プロパティの」を参照してください。

書式指定子	説明	例示
"d"	短い形式の日付パターン。詳細情報:短い日付 ("d") 書式指定子。	2009-06-15T13:45:30 -> 6/15/2009 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 (fr-FR) 2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
"D"	長い形式の日付パターン。詳細情報:長い日付 ("D") 書式指定子。	2009-06-15T13:45:30 -> Monday, June 15, 2009 (en-US) 2009-06-15T13:45:30 -> понедельник, 15 июня 2009 г. (ru-RU) 2009-06-15T13:45:30 -> Montag, 15. Juni 2009 (de-DE)
f	完全な日付と時刻のパターン (短い形式の時刻)。詳細情報:完全な日付と短い形式の時刻 ("f") 書式指定子。	2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45 PM (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 13:45 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45 μμ (el-GR)
"F"	完全な日付と時刻のパターン (長い形式の時刻)。詳細情報:完全な日付と長い形式の時刻 ("F") 書式指定子。	2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45:30 PM (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 13:45:30 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45:30 μμ (el-GR)
"g"	一般の日付と時刻のパターン (短い形式の時刻)。詳細情報:一般の日付と短い形式の時刻 ("g") 書式指定子。	2009-06-15T13:45:30 -> 6/15/2009 1:45 PM (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)
"G"	一般の日付と時刻のパターン (長い形式の時刻)。詳細情報:一般の日付と長い形式の時刻 ("G") 書式指定子。	2009-06-15T13:45:30 -> 6/15/2009 1:45:30 PM (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45:30 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN)
"M"、"m"	月日パターン。詳細情報:月 ("M"、"m") 書式指定子。	2009-06-15T13:45:30 -> June 15 (en-US) 2009-06-15T13:45:30 -> 15. juni (da-DK) 2009-06-15T13:45:30 -> 15 Juni (id-ID)
"O"、"o"	ラウンドトリップする日付と時刻のパターン。詳細情報:ラウンドトリップ ("O"、"o") 書式指定子。	DateTime 値: 2009-06-15T13:45:30 (DateTimeKind.Local) --> 2009-06-15T13:45:30.0000000-07:00 2009-06-15T13:45:30 (DateTimeKind.Utc) --> 2009-06-15T13:45:30.0000000Z 2009-06-15T13:45:30 (DateTimeKind.Unspecified) --> 2009-06-15T13:45:30.0000000 DateTimeOffset 値: 2009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.0000000-07:00
"R"、"r"	RFC1123 パターン。詳細情報:RFC1123 ("R"、"r") 書式指定子。	DateTimeOffset 入力: 2009-06-15T13:45:30 -> 月、2009 年 6 月 15 日 20:45:30 GMT DateTime 入力: 2009-06-15T13:45:30 -> 月、2009 年 6 月 15 日 13:45:30 GMT
"s"	並べ替え可能な日付と時刻のパターン。詳細情報:並べ替え可能な日付と時刻 ("s") 書式指定子。	2009-06-15T13:45:30 (DateTimeKind.Local) -> 2009-06-15T13:45:30 2009-06-15T13:45:30 (DateTimeKind.Utc) -> 2009-06-15T13:45:30
"t"	短い形式の時刻パターン。詳細情報:短い形式の時刻 ("t") 書式指定子。	2009-06-15T13:45:30 -> 1:45 PM (en-US) 2009-06-15T13:45:30 -> 13:45 (hr-HR) 2009-06-15T13:45:30 -> 01:45 م (ar-EG)
"T"	長い形式の時刻パターン。詳細情報:長い形式の時刻 ("T") 書式指定子。	2009-06-15T13:45:30 -> 1:45:30 PM (en-US) 2009-06-15T13:45:30 -> 13:45:30 (hr-HR) 2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)
"u"	並べ替え可能な日付と時刻のパターン (世界時刻)。詳細情報:世界共通の並べ替え可能な日付と時刻 ("u") 書式指定子。	DateTime 値: 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z DateTimeOffset 値: 2009-06-15T13:45:30 -> 2009-06-15 20:45:30Z
"U"	ユニバーサル完全な日付/時刻パターン。詳細情報: ユニバーサルフル ("U") 書式指定子。	2009-06-15T13:45:30 -> 2009 年 6 月 15 日月曜日 8:45:30 PM (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 20:45:30 (sv-SE) 2009-06-15T13:45:30 -> Δευεέρα, 15 Ιουνίου 2009 8:45:30 μμ (el-GR)
"Y"、"y"	年月パターン。詳細情報:年月 ("Y") 書式指定子。	2009-06-15T13:45:30 -> June 2009 (en-US) 2009-06-15T13:45:30 -> juni 2009 (da-DK) 2009-06-15T13:45:30 -> Juni 2009 (id-ID)
その他の 1 文字	未定義の指定子。	実行時の FormatExceptionをスローします。

標準書式指定文字列の動作

書式設定操作では、標準書式指定文字列はカスタム書式指定文字列のエイリアスにすぎません。エイリアスを使ってカスタム書式指定文字列を表すことの利点は、カスタム書式指定文字列はそれ自体が変化する場合があるのに対し、エイリアスは不変であるという点です。通常、日付と時刻の値の文字列形式はカルチャによって変わるため、この点は重要です。たとえば、"d" 標準書式指定文字列は、日付と時刻の値を短い日付形式のパターンで表示することを意味します。インバリアントカルチャでは、このパターンは "MM/dd/yyyy" になります。 fr-FR カルチャでは、これが "dd/MM/yyyy" になります。 ja-JP カルチャでは、これが "yyyy/MM/dd" になります。

書式設定操作の標準書式指定文字列が特定のカルチャのカスタム書式指定文字列に対応付けられている場合は、使用するカスタム書式指定文字列に該当するカルチャを次のいずれかの方法で定義できます。

既定の (現在の) カルチャを使用できます。次の例では、現在のカルチャの短い日付形式を使って日付を表示します。この場合、現在のカルチャは en-US です。

// Display using current (en-us) culture's short date format
DateTime thisDate = new DateTime(2008, 3, 15);
Console.WriteLine(thisDate.ToString("d"));           // Displays 3/15/2008

' Display using current (en-us) culture's short date format
Dim thisDate As Date = #03/15/2008#
Console.WriteLine(thisDate.ToString("d"))     ' Displays 3/15/2008

IFormatProvider パラメーターを持つメソッドに書式設定を使用するカルチャを表す CultureInfo オブジェクトを渡すことができます。次の例では、pt-BR カルチャの短い日付形式を使って日付を表示します。

// Display using pt-BR culture's short date format
DateTime thisDate = new DateTime(2008, 3, 15);
CultureInfo culture = new CultureInfo("pt-BR");
Console.WriteLine(thisDate.ToString("d", culture));  // Displays 15/3/2008

' Display using pt-BR culture's short date format
Dim thisDate As Date = #03/15/2008#
Dim culture As New CultureInfo("pt-BR")
Console.WriteLine(thisDate.ToString("d", culture))   ' Displays 15/3/2008

IFormatProvider パラメーターを持つメソッドに書式設定情報を提供する DateTimeFormatInfo オブジェクトを渡すことができます。次の使用例は、hr-HR カルチャの DateTimeFormatInfo オブジェクトの短い日付形式を使用して日付を表示します。

// Display using date format information from hr-HR culture
DateTime thisDate = new DateTime(2008, 3, 15);
DateTimeFormatInfo fmt = (new CultureInfo("hr-HR")).DateTimeFormat;
Console.WriteLine(thisDate.ToString("d", fmt));      // Displays 15.3.2008

' Display using date format information from hr-HR culture
Dim thisDate As Date = #03/15/2008#
Dim fmt As DateTimeFormatInfo = (New CultureInfo("hr-HR")).DateTimeFormat
Console.WriteLine(thisDate.ToString("d", fmt))   ' Displays 15.3.2008

注

日付と時刻の値の書式設定で使用されるパターンまたは文字列のカスタマイズについては、NumberFormatInfo クラスのトピックを参照してください。

標準書式指定文字列には、長いカスタム書式指定文字列に代わる、不変の省略形としての利用価値もあります。このカテゴリに該当する標準書式指定文字列は、"O" (または "o")、"R" (または "r")、"s"、"u" の 4 つです。これらの文字列は、インバリアントカルチャで定義されたカスタム書式指定文字列に対応します。これらの書式指定文字列によって生成される日時値の文字列形式は、カルチャに関係なく一定です。次の表で、この 4 つの標準日時書式指定文字列について説明します。

標準書式指定文字列	DateTimeFormatInfo.InvariantInfo プロパティによって定義されます	カスタム書式指定文字列
"O" または "o"	なし	yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffK
"R" または "r"	RFC1123Pattern	ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
"s"	SortableDateTimePattern	yyyy'-'MM'-'dd'T'HH':'mm':'ss
"u"	UniversalSortableDateTimePattern	yyyy'-'MM'-'dd HH':'mm':'ss'Z'

標準書式指定文字列は、DateTime.ParseExact メソッドまたは DateTimeOffset.ParseExact メソッドを使用した解析操作でも使用できます。解析操作を成功させるためには、入力文字列が特定のパターンに正確に準拠している必要があります。多くの標準書式指定文字列は複数のカスタム書式指定文字列にマップされるため、日付と時刻の値をさまざまな形式で表すことができますが、解析操作は引き続き成功します。 DateTimeFormatInfo.GetAllDateTimePatterns(Char) メソッドを呼び出すことで、標準書式指定文字列に対応するカスタム書式指定文字列を特定できます。次の例では、"d" (短い日付パターン) 標準書式指定文字列にマップされるカスタム書式指定文字列を表示します。

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      Console.WriteLine("'d' standard format string:");
      foreach (var customString in DateTimeFormatInfo.CurrentInfo.GetAllDateTimePatterns('d'))
          Console.WriteLine($"   {customString}");
   }
}
// The example displays the following output:
//       'd' standard format string:
//          M/d/yyyy
//          M/d/yy
//          MM/dd/yy
//          MM/dd/yyyy
//          yy/MM/dd
//          yyyy-MM-dd
//          dd-MMM-yy

Imports System.Globalization

Module Example
    Public Sub Main()
        Console.WriteLine("'d' standard format string:")
        For Each customString In DateTimeFormatInfo.CurrentInfo.GetAllDateTimePatterns("d"c)
            Console.WriteLine("   {0}", customString)
        Next
    End Sub
End Module
' The example displays the following output:
'    'd' standard format string:
'       M/d/yyyy
'       M/d/yy
'       MM/dd/yy
'       MM/dd/yyyy
'       yy/MM/dd
'       yyyy-MM-dd
'       dd-MMM-yy

次のセクションでは、DateTime 値と DateTimeOffset 値の標準書式指定子について説明します。

日付の形式

このグループには、次の形式が含まれます。

短い形式の日付 ("d") 書式指定子
長い形式の日付 ("D") 書式指定子

短い形式の日付 ("d") 書式指定子

"d" 標準書式指定子は、特定のカルチャの DateTimeFormatInfo.ShortDatePattern プロパティによって定義されるカスタム日時書式指定文字列を表します。たとえば、インバリアントカルチャの ShortDatePattern プロパティによって返されるカスタム書式指定文字列は、"MM/dd/yyyy" です。

次の表に、返される文字列の書式設定を制御する DateTimeFormatInfo オブジェクトのプロパティを示します。

プロパティ	説明
ShortDatePattern	結果文字列の全体的な形式を定義します。
DateSeparator	日付の年、月、日の各部分を区切る文字列を定義します。

次の例では、"d" 書式指定子を使用して日付と時刻の値を表示します。

DateTime date1 = new DateTime(2008,4, 10);
Console.WriteLine(date1.ToString("d", DateTimeFormatInfo.InvariantInfo));
// Displays 04/10/2008
Console.WriteLine(date1.ToString("d",
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays 4/10/2008
Console.WriteLine(date1.ToString("d",
                  CultureInfo.CreateSpecificCulture("en-NZ")));
// Displays 10/04/2008
Console.WriteLine(date1.ToString("d",
                  CultureInfo.CreateSpecificCulture("de-DE")));
// Displays 10.04.2008

Dim date1 As Date = #4/10/2008#
Console.WriteLine(date1.ToString("d", DateTimeFormatInfo.InvariantInfo))
' Displays 04/10/2008
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays 4/10/2008                       
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("en-NZ")))
' Displays 10/04/2008                       
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("de-DE")))
' Displays 10.04.2008

プロパティ	説明
LongDatePattern	結果文字列の全体的な形式を定義します。
DayNames	結果文字列に表示できるローカライズされた日の名前を定義します。
MonthNames	結果文字列に表示できるローカライズされた月の名前を定義します。

プロパティ	説明
LongDatePattern	結果文字列の日付コンポーネントの形式を定義します。
ShortTimePattern	結果文字列の時刻コンポーネントの形式を定義します。
DayNames	結果文字列に表示できるローカライズされた日の名前を定義します。
MonthNames	結果文字列に表示できるローカライズされた月の名前を定義します。
TimeSeparator	時刻の時間、分、および 2 番目の要素を区切る文字列を定義します。
AMDesignator	午前 0 時から正午までの時刻を 12 時間制で示す文字列を定義します。
PMDesignator	正午から午前 0 時までの時刻を 12 時間制で示す文字列を定義します。

プロパティ	説明
FullDateTimePattern	結果文字列の全体的な形式を定義します。
DayNames	結果文字列に表示できるローカライズされた日の名前を定義します。
MonthNames	結果文字列に表示できるローカライズされた月の名前を定義します。
TimeSeparator	時刻の時間、分、および 2 番目の要素を区切る文字列を定義します。
AMDesignator	午前 0 時から正午までの時刻を 12 時間制で示す文字列を定義します。
PMDesignator	正午から午前 0 時までの時刻を 12 時間制で示す文字列を定義します。

プロパティ	説明
ShortDatePattern	結果文字列の日付コンポーネントの形式を定義します。
LongTimePattern	結果文字列の時刻コンポーネントの形式を定義します。
DateSeparator	日付の年、月、日の各部分を区切る文字列を定義します。
TimeSeparator	時刻の時間、分、および 2 番目の要素を区切る文字列を定義します。
AMDesignator	午前 0 時から正午までの時刻を 12 時間制で示す文字列を定義します。
PMDesignator	正午から午前 0 時までの時刻を 12 時間制で示す文字列を定義します。

プロパティ	説明
RFC1123Pattern	結果文字列の形式を定義します。
AbbreviatedDayNames	結果文字列に表示できる省略された日の名前を定義します。
AbbreviatedMonthNames	結果文字列に表示できる省略された月の名前を定義します。

プロパティ	説明
MonthDayPattern	結果文字列の全体的な形式を定義します。
MonthNames	結果文字列に表示できるローカライズされた月の名前を定義します。

プロパティ	説明
YearMonthPattern	結果文字列の全体的な形式を定義します。
MonthNames	結果文字列に表示できるローカライズされた月の名前を定義します。

次の方法で共有

標準の日時書式指定文字列

書式指定子の表

標準書式指定文字列の動作

日付の形式

短い形式の日付 ("d") 書式指定子

長い形式の日付 ("D") 書式指定子

日付と時刻の形式

完全な日付と短い形式の時刻 ("f") 書式指定子

完全な日付と長い形式の時刻 ("F") 書式指定子

一般の日付と短い形式の時刻 ("g") 書式指定子

一般の日付と長い形式の時刻 ("G") 書式指定子

ラウンドトリップ ("O"、"o") 書式指定子

RFC1123 ("R"、"r") 書式指定子

並べ替え可能な日付と時刻 ("s") 書式指定子

世界共通の並べ替え可能な日付と時刻 ("u") 書式指定子

汎用完全 ("U") 書式指定子

時刻の形式

短い形式の時刻 ("t") 書式指定子

長い形式の時刻 ("T") 書式指定子

部分的な日付形式

月 ("M"、"m") 書式指定子

年月 ("Y"、"y") 書式指定子

コントロール パネルの設定

DateTimeFormatInfo プロパティ

こちらもご覧ください

その他のリソース

コントロールパネルの設定