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

[アーティクル]
05/30/2023

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

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

ヒント

書式指定ユーティリティである .NET Windows Forms をダウンロードできます。このアプリケーションを使用すると、書式指定文字列を数値または日付と時刻の値に適用して、結果の文字列を表示できます。ソースコードは 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 -> Mon, 15 Jun 2009 20:45:30 GMT DateTime 入力: 2009-06-15T13:45:30 -> Mon, 15 Jun 2009 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") 書式指定子。	With a DateTime value: 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z With a DateTimeOffset value: 2009-06-15T13:45:30 -> 2009-06-15 20:45:30Z
"U"	完全な日付と時刻のパターン (世界時刻)。詳細情報:世界共通の完全な日付と時刻 ("U") 書式指定子。	2009-06-15T13:45:30 -> Monday, June 15, 2009 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

使用する書式のカルチャを表す CultureInfo オブジェクトを、IFormatProvider パラメーターを持つメソッドに渡すことができます。次の例では、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

書式情報を提供する DateTimeFormatInfo オブジェクトを、IFormatProvider パラメーターを持つメソッドに渡すことができます。次の例では、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"	None	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) メソッドを呼び出すことにより、標準書式指定文字列に対応する 1 つまたは複数のカスタム書式指定文字列を確認できます。次の例では、"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("   {0}", 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	時刻の構成要素、つまり時間、分、および秒を区切る文字列を定義します。
AMDesignator	午前 0 時から正午前までの時刻を 12 時間形式で示す文字列を定義します。
PMDesignator	正午から午前 0 時前までの時刻を 12 時間形式で示す文字列を定義します。

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

プロパティ	説明
ShortDatePattern	結果文字列の日付要素の書式を定義します。
LongTimePattern	結果文字列の時刻要素の書式を定義します。
DateSeparator	日付の構成要素、つまり年、月、および日を区切る文字列を定義します。
TimeSeparator	時刻の構成要素、つまり時間、分、および秒を区切る文字列を定義します。
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 のプロパティ

関連項目

フィードバック

その他のリソース

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