DateTimeオブジェクトの時刻・日付から形式を指定して文字列に変換する - DateTimeからstringへの変換 - C#

DateTime型から文字列への変換コードを紹介します。

概要

DateTime型の時刻日付クラスをフォーマット形式を指定して文字列型に変換する場合はToString()メソッドを用います。
ToStringメソッドの引数に形式指定文字列を与えることで、指定した書式で日時の文字列を表示できます。

書式

コード記述例

DateTimeオブジェクトの dt を "yyyy-MM-dd HH-mm-ss ffff zzz" の形式の文字列に変換します。
「2019-10-24 23-14-22 2452 +09:00」の形式の文字列が出力されます。

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Windows.Forms;

namespace WindowsFormsApplication1
{
  public partial class Form1 : Form
  {
    public Form1()
    {
      InitializeComponent();
    }

    private void button1_Click(object sender, EventArgs e)
    {
      DateTime dt = DateTime.Now;
      textBox1.Text = dt.ToString("yyyy-MM-dd HH-mm-ss ffff zzz");
    }
  }
}

プログラム例 (標準DateTimeパターンの例)

形式パターンを用いた文字列変換のサンプルプログラムです。

UI

下図のUIを準備します。

コード

下記のコードを記述します。それぞれのボタンのClickイベントを実装します。

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Forms;

namespace DateTimeToString
{
  public partial class FormMain : Form
  {
    public FormMain()
    {
      InitializeComponent();
    }

    private void button1_Click(object sender, EventArgs e)
    {
      DateTime dt = DateTime.Now;
      textBox1.Text += dt.ToString("d")+"\r\n";

    }

    private void button2_Click(object sender, EventArgs e)
    {
      DateTime dt = DateTime.Now;
      textBox1.Text += dt.ToString("D") + "\r\n";

    }

    private void button3_Click(object sender, EventArgs e)
    {
      DateTime dt = DateTime.Now;
      textBox1.Text += dt.ToString("u") + "\r\n";

    }

    private void button4_Click(object sender, EventArgs e)
    {
      DateTime dt = DateTime.Now;
      textBox1.Text += dt.ToString("U") + "\r\n";

    }

    private void button5_Click(object sender, EventArgs e)
    {
      DateTime dt = DateTime.Now;
      textBox1.Text += dt.ToString("f") + "\r\n";

    }

    private void button6_Click(object sender, EventArgs e)
    {
      DateTime dt = DateTime.Now;
      textBox1.Text += dt.ToString("F") + "\r\n";

    }
  }
}

解説

button1

DateTime.Now プロパティで現在の日時を取得します。ToStringメソッドで文字列に変換します。ToStringメソッドの第一引数に "d" が与えられていますので、ShortDatePattern の"yyyy/MM/dd" 具体的には「2019/05/10」の形式で文字列に変換されます。

  DateTime dt = DateTime.Now;
  textBox1.Text += dt.ToString("d")+"\r\n";

button2

DateTime.Now プロパティで現在の日時を取得します。ToStringメソッドで文字列に変換します。ToStringメソッドの第一引数に "D" が与えられていますので、LongDatePattern の"yyyy?M?d" 具体的には「2019年5月10日」の形式で文字列に変換されます。

  DateTime dt = DateTime.Now;
  textBox1.Text += dt.ToString("D")+"\r\n";

button3

DateTime.Now プロパティで現在の日時を取得します。ToStringメソッドで文字列に変換します。ToStringメソッドの第一引数に "u" が与えられていますので、UniversalSortableDateTimePattern の"yyyy-MM-dd hh:mm:ss" 具体的には「2019-05-10 15:05:08」の形式で文字列に変換されます。

  DateTime dt = DateTime.Now;
  textBox1.Text += dt.ToString("u")+"\r\n";

button4

DateTime.Now プロパティで現在の日時を取得します。ToStringメソッドで文字列に変換します。ToStringメソッドの第一引数に "U" が与えられていますので、世界協定時刻を使用する完全な日付と時刻 (長い日付と長い時刻)の"yyyy?M?d hh:mm:s" 具体的には「2019年5月10日 15:05:08」の形式で文字列に変換されます。

  DateTime dt = DateTime.Now;
  textBox1.Text += dt.ToString("U")+"\r\n";

button5

DateTime.Now プロパティで現在の日時を取得します。ToStringメソッドで文字列に変換します。ToStringメソッドの第一引数に "f" が与えられていますので、完全な日付と時刻 の"yyyy?M?d hh:mm" 具体的には「2019年5月10日 15:05」の形式で文字列に変換されます。

  DateTime dt = DateTime.Now;
  textBox1.Text += dt.ToString("f")+"\r\n";

button6

DateTime.Now プロパティで現在の日時を取得します。ToStringメソッドで文字列に変換します。ToStringメソッドの第一引数に "F" が与えられていますので、FullDateTimePattern の"yyyy?M?d hh:mm:ss" 具体的には「2019年5月10日 15:05:08」の形式で文字列に変換されます。

  DateTime dt = DateTime.Now;
  textBox1.Text += dt.ToString("F")+"\r\n";

実行結果

プロジェクトを実行します。下図のウィンドウが表示されます。


[button1]をクリックします。"yyyy/MM/dd"形式の文字列がテキストボックスに表示されます。


[button2]～[button6]まで続けて押します。それぞれのボタンで指定した標準の書式パターンでの文字列がテキストボックスに表示されます。

標準DateTimeパターン

MSDNより抜粋した標準の形式パターンです。

プログラム例 (カスタムDateTimeパターンの例)

UI

下図のUIを作成します。ボタンと複数行テキストボックスを配置します。

コード

下記のコードを記述します。

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Forms;

namespace DateTimeToString
{
  public partial class FormCustomFormat : Form
  {
    public FormCustomFormat()
    {
      InitializeComponent();
    }

    private void Button1_Click(object sender, EventArgs e)
    {
      DateTime dt = DateTime.Now;
      textBox1.Text += dt.ToString("dd(ddd)-MM-yyyy zzz") + "\r\n";
    }

    private void Button2_Click(object sender, EventArgs e)
    {
      DateTime dt = DateTime.Now;
      textBox1.Text += dt.ToString("yyyy年M月d日 (dddd) HH:mm:ss [zzz]") + "\r\n";
    }
  }
}

解説

button1

DateTime.Now プロパティで現在の日時を取得します。ToStringメソッドで文字列に変換します。ToStringメソッドの第一引数に "dd(ddd)-MM-yyyy zzz" が与えられていますので、「20(火)-08-2019 +09:00」の形式で文字列に変換されます。

  DateTime dt = DateTime.Now;
  textBox1.Text += dt.ToString("dd(ddd)-MM-yyyy zzz") + "\r\n";

button2

DateTime.Now プロパティで現在の日時を取得します。ToStringメソッドで文字列に変換します。ToStringメソッドの第一引数に "yyyy年M月d日 (dddd) HH:mm:ss [zzz]" が与えられていますので、「2019年8月20日 (火曜日) 15:35:20 +09:00」の形式で文字列に変換されます。

  DateTime dt = DateTime.Now;
  textBox1.Text += dt.ToString("yyyy年M月d日 (dddd) HH:mm:ss [zzz]") + "\r\n";

実行結果

プロジェクトを実行します。下図のウィンドウが表示されます。


[button1]をクリックします。"dd(ddd)-MM-yyyy zzz"のフォーマットで現在時刻が文字列に変換されて表示できます。


[button2]をクリックします。"yyyy年M月d日 (dddd) HH:mm:ss [zzz]"のフォーマットで現在時刻が文字列に変換されて表示できます。

カスタムDateTimeパターン

カスタムの時刻表示指定書式です。