C#のDateTimeの書式：標準とカスタムの書式文字列、カルチャ、ISO 8601

DateTime.ToString(format) は日付をテキストに変換します。書式は、標準の書式文字列（d や o のような1文字で、正確なパターンはカルチャから決まります）か、yyyy、MM、HH などの指定子で組み立てるカスタムパターンのどちらかです。同じ文字列が補間 $"{date:yyyy-MM-dd}" でも string.Format でも使えます。

using System;
using System.Globalization;

class Program
{
    static void Main()
    {
        var shipped = new DateTime(2026, 10, 9, 18, 30, 7, 45);
        var inv = CultureInfo.InvariantCulture;

        Console.WriteLine(shipped.ToString("yyyy-MM-dd", inv));
        Console.WriteLine(shipped.ToString("yyyy-MM-dd HH:mm:ss", inv));
        Console.WriteLine(shipped.ToString("dd/MM/yyyy", inv));
        Console.WriteLine(shipped.ToString("MMM d, yyyy", inv));
        Console.WriteLine(shipped.ToString("dddd, MMMM d", inv));
        Console.WriteLine(shipped.ToString("h:mm tt", inv));
        Console.WriteLine(shipped.ToString("HH:mm:ss.fff", inv));
        Console.WriteLine($"Shipped {shipped:yyyy-MM-dd} at {shipped:HH:mm}");
    }
}

出力：

2026-10-09
2026-10-09 18:30:07
09/10/2026
Oct 9, 2026
Friday, October 9
6:30 PM
18:30:07.045
Shipped 2026-10-09 at 18:30

このページの例では、どのマシンでも出力が同じになるように CultureInfo.InvariantCulture を渡しています。渡さないと ToString は現在のカルチャを使い、月の名前、区切り文字、さらには暦まで変わることがあります。

カスタムの書式指定子

カスタムの書式は、特定の文字が日付の各部分を表すパターンです。大文字と小文字を区別します。M は月で m は分、H は24時間表記の時で h は12時間表記の時です。

それ以外の文字はそのままコピーされます。指定子でない英字も含まれるので、"YYYY-DD" は何も言わずに YYYY-DD と表示されます。.NETには大文字の Y や D の指定子はありません。

1文字だけの書式は、カスタムではなく標準の書式として読まれます。ToString("d") は日の数値ではなく短い日付のパターンです。日だけを得るには、ToString("%d") と書くか、Day プロパティを使います。

using System;
using System.Globalization;

class Program
{
    static void Main()
    {
        var d = new DateTime(2026, 10, 9, 18, 30, 7);
        var inv = CultureInfo.InvariantCulture;

        Console.WriteLine(d.ToString("d", inv));             // standard short date
        Console.WriteLine(d.ToString("%d", inv));            // custom: day of month
        Console.WriteLine(d.ToString("yyyyMMdd_HHmmss", inv)); // for file names
        Console.WriteLine(d.ToString("'Week of' MMM d", inv));
        Console.WriteLine(d.ToString("HH'h'mm", inv));
        Console.WriteLine(d.ToString("yyyy-MM-ddTHH:mm:ss", inv));
        Console.WriteLine(d.ToString("YYYY-DD", inv));      // not specifiers: copied
    }
}

出力：

10/09/2026
9
20261009_183007
Week of Oct 9
18h30
2026-10-09T18:30:07
YYYY-DD

標準の書式文字列

標準の書式は、実際のパターンがカルチャによって定義される1文字の書式です。各カルチャが独自の慣例を自動的に得られるので、ユーザーに見せるテキストに適しています。

using System;
using System.Globalization;

class Program
{
    static void Main()
    {
        var d = new DateTime(2026, 10, 9, 18, 30, 7, DateTimeKind.Utc);
        var inv = CultureInfo.InvariantCulture;

        foreach (string f in new[] { "d", "D", "f", "g", "G", "M", "Y", "t", "T", "o", "s", "u", "r" })
        {
            Console.WriteLine($"{f}  {d.ToString(f, inv)}");
        }

        var us = new CultureInfo("en-US");
        Console.WriteLine($"en-US d: {d.ToString("d", us)}, D: {d.ToString("D", us)}");
    }
}

出力：

d  10/09/2026
D  Friday, 09 October 2026
f  Friday, 09 October 2026 18:30
g  10/09/2026 18:30
G  10/09/2026 18:30:07
M  October 09
Y  2026 October
t  18:30
T  18:30:07
o  2026-10-09T18:30:07.0000000Z
s  2026-10-09T18:30:07
u  2026-10-09 18:30:07Z
r  Fri, 09 Oct 2026 18:30:07 GMT
en-US d: 10/9/2026, D: Friday, October 9, 2026

o、s、u、r はどのカルチャでも同じテキストを生成するので、ログ、ファイル名、データの交換に安全に使えます。DateTime に対する u と r は値をUTCに変換しないことに注意してください。値をそのまま表示してUTCというラベルを付けるだけなので、値がローカル時刻なら先に ToUniversalTime() を呼びます（または DateTime.UtcNow を使います）。（DateTimeOffset に対しては変換されます。）

カルチャによって出力が変わる

標準の書式、月と曜日の名前、/ と : の区切り文字は、すべてカルチャから来ます。ToString の2番目の引数としてカルチャを渡します。

using System;
using System.Globalization;

class Program
{
    static void Main()
    {
        var d = new DateTime(2026, 10, 9, 18, 30, 0);
        string[] cultures = { "en-US", "en-GB", "de-DE", "fr-FR", "ja-JP" };

        foreach (string name in cultures)
        {
            var c = new CultureInfo(name);
            Console.WriteLine($"{name}  {d.ToString("d", c)}");
        }

        var de = new CultureInfo("de-DE");
        Console.WriteLine(d.ToString("D", de));
        Console.WriteLine(d.ToString("D", new CultureInfo("fr-FR")));
        Console.WriteLine(d.ToString("dd/MM/yyyy", de));      // "/" becomes "."
        Console.WriteLine(d.ToString("dd'/'MM'/'yyyy", de));  // quoted: a real slash
    }
}

出力：

en-US  10/9/2026
en-GB  09/10/2026
de-DE  09.10.2026
fr-FR  09/10/2026
ja-JP  2026/10/09
Freitag, 9. Oktober 2026
vendredi 9 octobre 2026
09.10.2026
09/10/2026

カルチャのデータは固定されていません。LinuxとmacOSの.NETはシステムにインストールされたICUライブラリからデータを読み、.NET 5以降はWindows 10以降の.NETも同じです（.NET FrameworkはWindows自身のNLSのデータを使います）。そのため、パターンはバージョンやプラットフォームによってわずかに変わることがあります。たとえば最近のICUのリリースでは、米国の短い時刻の書式で「PM」の前に普通の空白ではなく細い改行なしの空白を置き、スペイン語の短い日付で先頭のゼロを付けないものもあります。表示用に書式設定したテキストを決して解析すべきでない理由が、もう1つ増えます。

ここから2つのルールが導かれます。人が読むテキストは、その人のカルチャで書式設定し（サーバーでは、サーバーのものではなくリクエストのカルチャで）、標準の書式を優先します。そうすれば、ドイツの読者は 09.10.2026 を、米国の読者は 10/9/2026 を見ます。プログラムが読むテキストには、CultureInfo.InvariantCulture と、yyyy-MM-dd や o のようなあいまいさのないパターンを使います。現在のカルチャで書き出した日付を別のマシンで解析するのは、日と月が入れ替わる典型的な原因です。

ISO 8601と"o"によるラウンドトリップ

ラウンドトリップの書式 "o" はすべてのティックとゾーンの情報を書き出すので、そのテキストを解析すると、Kind も含めてまったく同じ DateTime が得られます。

using System;
using System.Globalization;

class Program
{
    static void Main()
    {
        var inv = CultureInfo.InvariantCulture;
        var utc = new DateTime(2026, 10, 9, 18, 30, 7, 45, DateTimeKind.Utc);
        var unspecified = new DateTime(2026, 10, 9, 18, 30, 7, 45);
        var offset = new DateTimeOffset(2026, 10, 9, 20, 30, 7, TimeSpan.FromHours(2));

        string stored = utc.ToString("o", inv);
        Console.WriteLine(stored);
        Console.WriteLine(unspecified.ToString("o", inv));
        Console.WriteLine(offset.ToString("o", inv));

        DateTime back = DateTime.Parse(stored, inv, DateTimeStyles.RoundtripKind);
        Console.WriteLine(back == utc);
        Console.WriteLine(back.Kind);

        Console.WriteLine(utc.ToString("yyyy-MM-ddTHH:mm:ssK", inv));    // no fractions
        Console.WriteLine(offset.ToString("yyyy-MM-dd HH:mm zzz", inv));
    }
}

出力：

2026-10-09T18:30:07.0450000Z
2026-10-09T18:30:07.0450000
2026-10-09T20:30:07.0000000+02:00
True
Utc
2026-10-09T18:30:07Z
2026-10-09 20:30 +02:00

接尾辞の Z はUTCを表し、Kind が Unspecified の DateTime には接尾辞が付かず、ローカル時刻や DateTimeOffset にはオフセット（+02:00）が付きます。Kind が保たれるように、DateTimeStyles.RoundtripKind を指定して解析します。JSONのシリアライザー、データベース、JavaScriptの Date はすべてこの形式を読めます。

TimeSpanの書式設定

TimeSpan には、より小さな独自のカスタム指定子の集まりがあります：d（日）、hh、mm、ss、fff。DateTime と違い、: や . を含むすべてのリテラルの文字を、バックスラッシュでエスケープするか引用符で囲む必要があります。

using System;

class Program
{
    static void Main()
    {
        var elapsed = new TimeSpan(1, 3, 25, 9, 120);   // 1 day 3:25:09.120

        Console.WriteLine(elapsed.ToString());
        Console.WriteLine(elapsed.ToString("c"));
        Console.WriteLine(elapsed.ToString(@"hh\:mm\:ss"));        // hours component only
        Console.WriteLine(elapsed.ToString(@"d\.hh\:mm"));
        Console.WriteLine(elapsed.ToString(@"mm\:ss\.fff"));
        Console.WriteLine($"{(int)elapsed.TotalHours}:{elapsed.Minutes:D2}");  // 27:25
    }
}

出力：

1.03:25:09.1200000
1.03:25:09.1200000
03:25:09
1.03:25
25:09.120
27:25

TimeSpan の書式の hh は時間の成分（0から23）なので、27時間の期間は 03 と表示されます。1日を超える合計には、最後の行のように TotalHours から計算します。バックスラッシュのない elapsed.ToString("hh:mm") は FormatException を投げます。

よくある間違い

• 月に mm を使う。 "yyyy-mm-dd" は真ん中に分を表示します：2026-30-09。月は MM です。
• tt なしの hh。 "hh:mm" はAMもPMもない12時間表記なので、06:30があいまいになります。24時間表記には HH を使います。
• YYYY と DD。 .NETでは指定子ではなく、そのまま表示されます。yyyy と dd を使います。
• データ用のパターンの /。 カルチャの日付の区切り文字です。引用符で囲むか、インバリアントカルチャを使います。
• ログやファイルでの既定の ToString()。 書式がマシンに依存します。書式とカルチャを渡します。
• UTCとラベルを付けたローカル時刻。 "u"、"r"、手書きの 'Z' は変換しません。先に変換します。
• 書き出したときとは異なるパターンで解析する。 データ用の書式文字列は1つの定数にまとめ、ToString と ParseExact の両方で使います。