C#のDateTime.ToString()メソッドの使い方を解説!書式指定子とサンプルコード
C#のDateTime.ToString()メソッドは、DateTimeオブジェクトが保持する日時の値を、それと等価な文字列(string)に変換するためのメソッドです。日付や時刻を画面に表示したり、ログファイルに出力したりする際に頻繁に使われる、非常に重要な基本メソッドの一つです。
構文(Syntax)
DateTime.ToString()メソッドには、以下の4つのオーバーロードが用意されています。
ToString() ToString(IFormatProvider) ToString(String) ToString(String, IFormatProvider)
- ToString() … 実行環境の現在のカルチャ設定に従って文字列に変換します。
- ToString(IFormatProvider) … 指定したカルチャ固有の書式情報を使って変換します。
- ToString(String) … 指定した標準またはカスタム書式指定子に従って変換します。
- ToString(String, IFormatProvider) … 書式指定子とカルチャ情報の両方を指定して変換します。
使用例1:ToString()メソッド
まずは、引数なしで呼び出す最もシンプルな例を見てみましょう。
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.ToString();
Console.WriteLine("String representation = {0}", str);
}
}
出力結果
Date = 11/11/2019 7:11:25 AM String representation = 11/11/2019 7:11:25 AM
※ 出力される日時の形式は、実行環境のカルチャ(地域・言語)設定によって異なります。日本語環境では「2019/11/11 7:11:25」のように表示されるのが一般的です。
使用例2:ToString(String)メソッド
次に、書式指定子 "f" を指定した例を紹介します。"f"は「完全な日付パターン + 短い時刻パターン」を意味する標準書式指定子で、曜日や年月日を含む読みやすい形式で出力されます。
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.ToString("f");
Console.WriteLine("String representation = {0}", str);
}
}
出力結果
Date = 11/11/2019 7:11:25 AM String representation = Monday, November 11, 2019 7:11 AM
まとめ
DateTime.ToString()メソッドを使えば、日時データを目的の形式の文字列へ簡単に変換できます。引数なしの呼び出しでは環境のカルチャ設定に依存しますが、書式指定子やIFormatProviderを組み合わせることで、「yyyy/MM/dd HH:mm」のようなカスタム形式や、特定の言語圏向けの表示にも柔軟に対応できます。用途に応じて適切なオーバーロードを選択しましょう。
-
C#のDateTime.ToBinary()メソッドの使い方を徹底解説
DateTime.ToBinary()メソッドとはC#のDateTime.ToBinary()メソッドは、現在のDateTimeオブジェクトを、後から同じオブジェクトとして復元できる64ビットのバイナリ値にシリアル化するためのメソッドです。戻り値は64ビット符号付き整数(long型)となり、この値を保存しておけば、あとから日付と時刻の情報を正確に再現することが可能です。構文このメソッドの構文は以下の通りです。public long ToBinary ();引数は取らず、呼び出し元のDateTimeオブジェクトをシリアル化した結果をlong型で返します。使用例1:固定の日時をシリアル化するまずは
-
【C#入門】DateTime.Subtract()メソッドの使い方を徹底解説
C#のDateTime.Subtract()メソッドは、指定したDateTime(日時)またはTimeSpan(時間間隔)を減算するために使用されるメソッドです。2つの日時の差を計算したい場合や、特定の日時から一定の期間を引き算したい場合に活用できます。DateTime.Subtract()メソッドの構文DateTime.Subtract()メソッドには、以下の2つのオーバーロードが用意されています。public TimeSpan Subtract (DateTime value); public DateTime Subtract (TimeSpan value);DateTime型を引数に