• 日時（DateTimeオブジェクト）を文字列に変換する
  • メソッドを使用する
  • 書式を指定して日時を文字列に変換する
    • 標準の日時書式指定文字列
    • カスタム日時書式指定文字列
  • カルチャを指定する
  • 和暦で表示する（年号を表示する）

• この記事への評価、コメント

日時（DateTimeオブジェクト）を文字列に変換する

ここではDateTimeオブジェクトを書式化された文字列に変換する方法を紹介します。DateTimeだけでなく、DateTimeOffsetやTimeSpanに関する説明も若干含まれています。

メソッドを使用する

DateTimeオブジェクトを文字列に変換するには、ToStringメソッドを使います。DateTimeではToStringの他に、ToShortDateString、ToLongDateString、ToShortTimeString、ToLongTimeStringメソッドで文字列に変換することもできます。

これらのメソッドの違いを以下に示します。

Dim dt As DateTime = New DateTime(2002, 5, 12, 20, 30, 15, 123)

Console.WriteLine("ToString :{0}", dt.ToString())
'2002/05/12 20:30:15
Console.WriteLine("ToShortDateString :{0}", dt.ToShortDateString())
'2002/05/12
Console.WriteLine("ToLongDateString :{0}", dt.ToLongDateString())
'2002年5月12日
Console.WriteLine("ToShortTimeString :{0}", dt.ToShortTimeString())
'20:30
Console.WriteLine("ToLongTimeString :{0}", dt.ToLongTimeString())
'20:30:15

DateTime dt = new DateTime(2002, 5, 12, 20, 30, 15, 123);

Console.WriteLine("ToString :{0}", dt.ToString());
//2002/05/12 20:30:15
Console.WriteLine("ToShortDateString :{0}", dt.ToShortDateString());
//2002/05/12
Console.WriteLine("ToLongDateString :{0}", dt.ToLongDateString());
//2002年5月12日
Console.WriteLine("ToShortTimeString :{0}", dt.ToShortTimeString());
//20:30
Console.WriteLine("ToLongTimeString :{0}", dt.ToLongTimeString());
//20:30:15

書式を指定して日時を文字列に変換する

さらに、書式を指定してDateTimeオブジェクトを文字列に変換することもできます。書式を指定するには、ToStringメソッドのパラメータに書式を文字列で渡します。

日時を文字列に変換する時に使用できる書式の文字列は、「日時書式指定文字列」と呼びます。また、日時書式指定文字列は、「標準の日時書式指定文字列」と「カスタム日時書式指定文字列」に分けることができます。

標準の日時書式指定文字列は、アルファベット1文字で表され、すでに定義されている決まった書式に従って文字列に変換します。例えば、"F"という書式を使うと、ToLongDateStringとToLongTimeStringメソッドが返す文字列を空白文字で繋げたような文字列に変換されます。

カスタム日時書式指定文字列は、複数の書式指定子（特別な意味のある文字）を組み合わせて作ることができます。よって、カスタム日時書式指定文字列はより複雑な書式を記述できます。

日時書式指定文字列を使用してDataTimeオブジェクトを文字列に変換する簡単な例を示します。

Dim dt As New DateTime(2000, 5, 12, 20, 30, 15, 123)

Console.WriteLine(dt.ToString("F"))
'2000年5月12日 20:30:15
Console.WriteLine(dt.ToString("gyyyy年MM月dd日(dddd)"))
'西暦2000年05月12日(金曜日)
Console.WriteLine(dt.ToString("tthh時mm分ss秒fffミリ秒"))
'午後08時30分15秒123ミリ秒

DateTime dt = new DateTime(2000, 5, 12, 20, 30, 15, 123);

Console.WriteLine(dt.ToString("F"));
//2000年5月12日 20:30:15
Console.WriteLine(dt.ToString("gyyyy年MM月dd日(dddd)"));
//西暦2000年05月12日(金曜日)
Console.WriteLine(dt.ToString("tthh時mm分ss秒fffミリ秒"));
//午後08時30分15秒123ミリ秒

日時書式指定文字列については下でさらに詳しく説明しますが、MSDNでは以下のページで説明されていますので、そちらも参考にしてください。

• 標準の日付と時刻の書式指定文字列
• カスタムの日付と時刻の書式指定文字列
• 標準の時間間隔書式指定文字列
• カスタム時間間隔書式指定文字列

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

以下に、標準の日時書式指定文字列で使用できる書式指定子を表にまとめます。

カスタム日時書式指定文字列

以下に、カスタム日時書式指定文字列で使用できる書式指定子を表にまとめます。

カルチャを指定する

日時を文字列に変換する時、その結果は現在のカルチャによって変わります。さらに詳しく言えば、日時をどのような文字列に変換するかという定義は、現在のカルチャのCultureInfo.DateTimeFormatプロパティで決まります。

ToStringメソッドで文字列を変換する場合はパラメータにIFormatProviderを指定することができるため、現在のカルチャを変更しなくても、指定したカルチャを使って変換できます。

カルチャを en-US にしてDataTimeを文字列に変換する例を以下に示します。

Dim dt As New DateTime(2000, 5, 12, 20, 30, 15, 123)

'カルチャを en-US にしてDataTimeを文字列に変換する
Dim ci As New System.Globalization.CultureInfo("en-US")
Console.WriteLine(dt.ToString("F", ci))
'Friday, May 12, 2000 8:30:15 PM

DateTime dt = new DateTime(2000, 5, 12, 20, 30, 15, 123);

//カルチャを en-US にしてDataTimeを文字列に変換する
System.Globalization.CultureInfo ci =
    new System.Globalization.CultureInfo("en-US");
Console.WriteLine(dt.ToString("F", ci));
//Friday, May 12, 2000 8:30:15 PM

和暦で表示する（年号を表示する）

「昭和62年」のように年号を使った和暦で表示するには、カルチャを日本語（ja-JP）にします。設定によってはこれだけで和暦表示されることもありますが、大抵はそうなりません（詳しくは後述）。DateTimeFormatInfo.CalendarプロパティにJapaneseCalendarオブジェクトを設定すれば、設定に関わらず和暦表示できます。

'和暦でDataTimeを文字列に変換する
Dim ci As New System.Globalization.CultureInfo("ja-JP", False)
ci.DateTimeFormat.Calendar = New System.Globalization.JapaneseCalendar()

Console.WriteLine(dt.ToString("gy年MM月dd日(dddd)", ci))
'平成12年05月12日(金曜日)

Console.WriteLine(dt.ToString("D", ci))
'平成 12年5月12日

Console.WriteLine(dt.ToString("d", ci))
'平成 12/5/12

Console.WriteLine(dt.ToString("Y", ci))
'平成 12年5月

DateTime dt = new DateTime(2000, 5, 12, 20, 30, 15, 123);

//和暦でDataTimeを文字列に変換する
System.Globalization.CultureInfo ci =
    new System.Globalization.CultureInfo("ja-JP", false);
ci.DateTimeFormat.Calendar = new System.Globalization.JapaneseCalendar();

Console.WriteLine(dt.ToString("gy年MM月dd日(dddd)", ci));
//平成12年05月12日(金曜日)

Console.WriteLine(dt.ToString("D", ci));
//平成 12年5月12日

Console.WriteLine(dt.ToString("d", ci));
//平成 12/5/12

Console.WriteLine(dt.ToString("Y", ci));
//平成 12年5月

この例のように、「g」という書式指定文字列で年号（元号）を、「y」という書式指定文字列で和暦の年を表示できます（「g」や「y」の数が違っても結果は同じようでした）。また、書式指定文字列「D」「d」「Y」などで表示される日付パターンも和暦で表示されます。これは、JapaneseCalendarを指定したことにより、DateTimeFormatInfo.LongDatePatternプロパティが「gg y'年'M'月'd'日'」に、ShortDatePatternプロパティが「gg y/M/d」に、YearMonthPatternプロパティが「gg y'年'M'月'」に変わったためです。

上の例ではCultureInfoのコンストラクタの2番目のパラメータに「false」を指定していますが、このようにするとCultureInfoのUseUserOverrideプロパティがfalseに設定されます。指定しない時は、trueになります。CultureInfoのUseUserOverrideプロパティがtrueで、OSの現在のカルチャと互換性がある場合は、ユーザーが「コントロールパネル」で設定した値の一部を使用してCultureInfoを作成します。falseの場合はユーザーの設定を使用しません。

この例ではDateTimeFormatInfo.Calendarプロパティに直接JapaneseCalendarを設定しているため、UseUserOverrideがtrueでもfalseでも和暦で表示できます。ちなみにコントロールパネルの設定で和暦を使用するようにしている時は、UseUserOverrideをtrueにすると、JapaneseCalendarを指定しなくても和暦で表示できます。

「ja-JP」以外のカルチャでもJapaneseCalendarを指定できるかというと、たぶんダメです。カルチャに指定できるCalendarは決まっており、CultureInfo.OptionalCalendarsプロパティで返される配列に含まれるCalendarだけです。ちなみに「ja-JP」の場合は、GregorianCalendarとJapaneseCalendarだけです。

JapaneseCalendarがサポートしている最も古い時刻は「1868/09/08 0:00:00」ですので、それ以前の時刻には対応していません。

• 関連：
• 書式を指定して数値を文字列に変換する
• 日時を表す文字列をDateTimeオブジェクトに変換する

• 履歴：
• 2007/1/19 表を追加。
• 2010/12/10 全面的に書き換える。
• 2011/10/31 「和暦で表示する」を追加。表の例にen-USを追加。
• 2012/5/16 「カスタム日時書式指定文字列」の「FF」の説明で、「左側に 0 があっても...」を「右側に 0 があっても...」に修正（コメントでご指摘いただいました）。