C#のDateTime.ToLongTimeString()メソッドの使い方を徹底解説

C#のDateTime.ToLongTimeString()メソッドは、現在のDateTimeオブジェクトの値を、それに対応する長い形式（ロングタイム）の時刻文字列に変換するために使用されます。カルチャ（CultureInfo）の設定に応じた時刻表現で文字列が返されるため、地域ごとの表示形式に自動的に対応できるのが特徴です。

構文

ToLongTimeString()メソッドの構文は以下のとおりです。

public string ToLongTimeString ();

引数は不要で、呼び出すだけで現在のDateTimeオブジェクトの時刻部分を長い形式の文字列として取得できます。

使用例1：現在の日時を変換する

まずは、DateTime.ToLongTimeString()メソッドを使って現在時刻を変換する基本的な例を見てみましょう。

using System;
using System.Globalization;
public class Demo {
   public static void Main() {
      DateTime d = DateTime.Now;
      Console.WriteLine("Date = {0}", d);
      Console.WriteLine("Current culture = "+CultureInfo.CurrentCulture.Name);
      var pattern = CultureInfo.CurrentCulture.DateTimeFormat;
      string str = d.ToLongTimeString();
      Console.WriteLine("Long time string = {0}", pattern.LongTimePattern);
      Console.WriteLine("Long time string representation = {0}", str);
   }
}

実行結果

上記のコードを実行すると、以下のような出力が得られます。

Date = 10/16/2019 8:41:03 AM
Current culture = en-US
Long time string = h:mm:ss tt
Long time string representation = 8:41:03 AM

この例では、現在のカルチャが「en-US」であるため、時刻パターン「h:mm:ss tt」に従い、「8:41:03 AM」という形式で出力されています。実行環境のカルチャ設定によって、表示される形式は自動的に変わります。

使用例2：特定の日時を変換する

続いて、任意の日時を指定してToLongTimeString()メソッドを使用する例です。

using System;
public class Demo {
   public static void Main() {
      DateTime d = new DateTime(2019, 11, 11, 7, 11, 25);
      Console.WriteLine("Date = {0}", d);
      string str = d.ToLongTimeString();
      Console.WriteLine("Long time string representation = {0}", str);
   }
}

実行結果

このコードを実行すると、次の出力が得られます。

Date = 11/11/2019 7:11:25 AM
Long time string representation = 7:11:25 AM

まとめ

DateTime.ToLongTimeString()メソッドを使えば、DateTimeオブジェクトの時刻部分を簡単に長い形式の文字列へ変換できます。カルチャ情報に基づいて表示形式が決まるため、多言語・多地域対応のアプリケーションでも一貫した時刻表示を実現したい場合に便利なメソッドです。