C#の長い時刻（T）書式指定子の使い方をわかりやすく解説

C#の「T」書式指定子とは

C#における標準の日時書式指定子「T」は、長い時刻（Long Time）パターンでDateTimeオブジェクトを文字列に変換するための指定子です。

この指定子が実際に使用するカスタム書式文字列は、対象カルチャ（CultureInfo）に対応する DateTimeFormatInfo.LongTimePattern プロパティによって定義されます。たとえば、インバリアントカルチャでは次のカスタム書式文字列に相当します。

HH:mm:ss

サンプルコード

以下の例では、「T」書式指定子を使って、日時を英語（米国）カルチャの長い時刻形式で表示しています。

using System;
using System.Globalization;

class Demo {
    static void Main() {
        DateTime date = new DateTime(2018, 9, 9, 8, 15, 30);
        Console.WriteLine(date.ToString("T", CultureInfo.CreateSpecificCulture("en-us")));
    }
}

実行結果

8:15:30 AM

ポイント解説

出力結果は「8:15:30 AM」となっています。これは、en-USカルチャの LongTimePattern が「h:mm:ss tt」と定義されているためで、午前・午後（AM/PM）を含む12時間表記で表示されるからです。

つまり、「T」指定子の出力形式はカルチャに依存します。たとえば、日本語（ja-JP）カルチャでは「H:mm:ss」が使われるため、同じコードでも次のような出力になります。

8:15:30

このように、「T」書式指定子を利用すれば、ユーザーの地域設定に応じた自然な時刻表示を簡単に実現できます。カルチャを明示的に指定せずに現在のスレッドのカルチャ設定を使いたい場合は、date.ToString("T") のように記述することも可能です。