C#
 Computer >> コンピューター >  >> プログラミング >> C#

C#のDateTime.ToLongDateString()メソッドとは?使い方とサンプルコードを解説

C#のDateTime.ToLongDateString()メソッドは、現在のDateTimeオブジェクトが持つ日付の値を、それに対応する「長い日付形式」の文字列表現に変換するために使用されます。

このメソッドは引数を受け取らず、戻り値として文字列(string)を返します。なお、出力される書式は実行環境のCurrentCulture(現在のカルチャ)に依存する点が特徴です。

構文

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

public string ToLongDateString ();

使用例1:基本的な使い方

まずは、具体的な日時を指定してToLongDateString()メソッドを使用する基本的な例を見てみましょう。

using System;
public class Demo {
    public static void Main() {
        DateTime d = new DateTime(2019, 10, 11, 9, 10, 45);
        Console.WriteLine("Date = {0}", d);
        string str = d.ToLongDateString();
        Console.WriteLine("Long date string representation = {0}", str);
    }
}

出力結果

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

Date = 10/11/2019 9:10:45 AM
Long date string representation = Friday, October 11, 2019

このように、元の日付データ「2019年10月11日」が、「Friday, October 11, 2019」という曜日と月名を含む長い日付形式の文字列に変換されていることが確認できます。

使用例2:カルチャ情報との組み合わせ

続いて、CultureInfoクラスを使って現在のカルチャと長い日付パターンを確認しながら、ToLongDateString()メソッドを使用する例を紹介します。

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.ToLongDateString();
        Console.WriteLine("Long date string = {0}", pattern.LongDatePattern);
        Console.WriteLine("Long date string representation = {0}", str);
    }
}

出力結果

このコードを実行すると、以下のような結果になります。

Date = 10/16/2019 8:39:08 AM
Current culture = en-US
Long date string = dddd, MMMM d, yyyy
Long date string representation = Wednesday, October 16, 2019

ポイントまとめ

  • ToLongDateString()メソッドは、DateTimeの値を長い日付形式の文字列に変換して返します。
  • 変換結果はシステムの現在のカルチャ(CultureInfo.CurrentCulture)によって変わります。
  • en-USカルチャの場合は「dddd, MMMM d, yyyy」パターン(例:Wednesday, October 16, 2019)で出力されます。
  • 日本語(ja-JP)環境では「2019年10月16日水曜日」のように表示されるため、多言語対応アプリケーションではカルチャへの依存に注意が必要です。
  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型を引数に

  2. C#のDateTime.AddYears()メソッドとは?使い方をわかりやすく解説

    C#のDateTime.AddYears()メソッドは、このインスタンスが表す日時に指定した年数を加算し、その結果を新しいDateTimeとして返します。DateTimeは不変(イミュータブル)な構造体であるため、元のインスタンスの値が変更されることはありません。構文public DateTime AddYears (int yrs);パラメータ yrs には、加算する年数を整数で指定します。年数を減算したい場合は、負の値を渡してください。押さえておきたいポイント戻り値は計算結果を表す新しいDateTimeインスタンスで、元の日時には影響しません。うるう日の2月29日に対して加算・減算を行い、