DateTimePicker

[C#] DateTimePickerで日付と時刻を操作する方法

2025-01-18更新日: 2025-01-18

C#のDateTimePickerコントロールは、ユーザーが日付や時刻を選択できるUI要素です。

日付と時刻を操作するには、まずDateTimePickerのFormatプロパティを設定します。

日付を選択する場合はDateTimePickerFormat.ShortやDateTimePickerFormat.Longを使用し、時刻を選択する場合はDateTimePickerFormat.Timeを使用します。

選択された日付や時刻はValueプロパティで取得でき、Valueプロパティに新しいDateTimeオブジェクトを割り当てることで日付や時刻をプログラムから設定することも可能です。

これにより、ユーザーインターフェースを通じて簡単に日付と時刻を操作できます。

目次から探す

日付の操作
時刻の操作
DateTimePickerのカスタマイズ
DateTimePickerの応用例
まとめ

日付の操作

日付フォーマットの設定

C#のDateTimePickerコントロールでは、日付の表示形式をカスタマイズすることができます。

以下のコードは、日付フォーマットを設定する方法を示しています。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // DateTimePickerのフォーマットを設定
        dateTimePicker1.Format = DateTimePickerFormat.Custom;
        dateTimePicker1.CustomFormat = "yyyy年MM月dd日"; // 表示形式を設定
    }
}

このコードでは、CustomFormatプロパティを使用して、日付を「年-月-日」の形式で表示しています。

日付の取得方法

DateTimePickerから選択された日付を取得するには、Valueプロパティを使用します。

以下のサンプルコードでは、ボタンをクリックしたときに選択された日付を取得し、表示します。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
    }
    private void button1_Click(object sender, EventArgs e)
    {
        // DateTimePickerから日付を取得
        DateTime selectedDate = dateTimePicker1.Value;
        
        // 取得した日付を表示
        MessageBox.Show($"選択された日付: {selectedDate.ToString("yyyy年MM月dd日")}");
    }
}

このコードでは、ボタンがクリックされると、dateTimePicker1から選択された日付が取得され、メッセージボックスに表示されます。

日付の設定方法

DateTimePickerに特定の日付を設定するには、ValueプロパティにDateTimeオブジェクトを代入します。

以下のコードは、初期値として特定の日付を設定する方法を示しています。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // DateTimePickerに初期値を設定
        dateTimePicker1.Value = new DateTime(2023, 10, 1); // 2023年10月1日を設定
    }
}

このコードでは、dateTimePicker1の初期値を2023年10月1日に設定しています。

これにより、フォームが表示されたときにこの日付が選択された状態になります。

時刻の操作

時刻フォーマットの設定

DateTimePickerコントロールを使用して時刻の表示形式を設定することも可能です。

以下のコードでは、時刻フォーマットを設定する方法を示しています。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // DateTimePickerのフォーマットを時刻に設定
        dateTimePicker1.Format = DateTimePickerFormat.Time;
        dateTimePicker1.ShowUpDown = true; // スピンボタンを表示
    }
}

このコードでは、FormatプロパティをDateTimePickerFormat.Timeに設定し、時刻のみを表示するようにしています。

また、ShowUpDownプロパティをtrueにすることで、スピンボタンを表示し、時刻を選択しやすくしています。

時刻の取得方法

DateTimePickerから選択された時刻を取得するには、Valueプロパティを使用します。

以下のサンプルコードでは、ボタンをクリックしたときに選択された時刻を取得し、表示します。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
    }
    private void button1_Click(object sender, EventArgs e)
    {
        // DateTimePickerから時刻を取得
        DateTime selectedTime = dateTimePicker1.Value;
        
        // 取得した時刻を表示
        MessageBox.Show($"選択された時刻: {selectedTime.ToString("HH:mm:ss")}");
    }
}

このコードでは、ボタンがクリックされると、dateTimePicker1から選択された時刻が取得され、メッセージボックスに表示されます。

時刻は「時:分:秒」の形式で表示されます。

時刻の設定方法

DateTimePickerに特定の時刻を設定するには、ValueプロパティにDateTimeオブジェクトを代入します。

以下のコードは、初期値として特定の時刻を設定する方法を示しています。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // DateTimePickerに初期値を設定
        dateTimePicker1.Value = new DateTime(2023, 10, 1, 14, 30, 0); // 2023年10月1日14時30分を設定
    }
}

このコードでは、dateTimePicker1の初期値を2023年10月1日の14時30分に設定しています。

これにより、フォームが表示されたときにこの時刻が選択された状態になります。

DateTimePickerのカスタマイズ

カスタムフォーマットの使用

DateTimePickerコントロールでは、カスタムフォーマットを使用して日付や時刻の表示形式を自由に設定できます。

以下のコードは、カスタムフォーマットを使用して日付を表示する方法を示しています。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // DateTimePickerのフォーマットをカスタムに設定
        dateTimePicker1.Format = DateTimePickerFormat.Custom;
        dateTimePicker1.CustomFormat = "dddd, yyyy年MM月dd日"; // 曜日を含むカスタムフォーマット
    }
}

このコードでは、CustomFormatプロパティを使用して、曜日を含むカスタムフォーマットを設定しています。

これにより、選択された日付が「曜日, 年-月-日」の形式で表示されます。

カレンダーの外観変更

DateTimePickerのカレンダーの外観を変更することも可能です。

以下のコードでは、カレンダーの背景色やフォントを変更する方法を示しています。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // DateTimePickerのカレンダーの外観を変更
        dateTimePicker1.CalendarForeColor = Color.Blue; // 文字色を青に設定
        dateTimePicker1.CalendarMonthBackground = Color.LightYellow; // 背景色を薄い黄色に設定
    }
}

このコードでは、CalendarForeColorプロパティで文字色を青に、CalendarMonthBackgroundプロパティでカレンダーの背景色を薄い黄色に設定しています。

これにより、カレンダーの見た目がカスタマイズされます。

ユーザー入力の制限

DateTimePickerでは、ユーザーが選択できる日付や時刻の範囲を制限することができます。

以下のコードでは、選択可能な日付の範囲を設定する方法を示しています。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // DateTimePickerの選択可能な日付の範囲を設定
        dateTimePicker1.MinDate = new DateTime(2023, 1, 1); // 最小日付
        dateTimePicker1.MaxDate = new DateTime(2023, 12, 31); // 最大日付
    }
}

このコードでは、MinDateプロパティとMaxDateプロパティを使用して、選択可能な日付の範囲を2023年1月1日から2023年12月31日までに制限しています。

これにより、ユーザーは指定された範囲内の日付のみを選択できるようになります。

DateTimePickerの応用例

日付範囲の選択

DateTimePickerを使用して、ユーザーが特定の日付範囲を選択できるようにすることができます。

以下のコードでは、開始日と終了日を選択するための2つのDateTimePickerを使用しています。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // 開始日と終了日を設定
        dateTimePickerStart.MinDate = new DateTime(2023, 1, 1);
        dateTimePickerEnd.MinDate = dateTimePickerStart.Value; // 終了日の最小値を開始日と同じに設定
    }
    private void dateTimePickerStart_ValueChanged(object sender, EventArgs e)
    {
        // 開始日が変更されたときに終了日の最小値を更新
        dateTimePickerEnd.MinDate = dateTimePickerStart.Value;
    }
}

このコードでは、開始日が変更されると、終了日の最小値が自動的に更新され、ユーザーが選択できる日付範囲が制限されます。

日付と時刻の同時選択

DateTimePickerを使用して、日付と時刻を同時に選択できるようにすることも可能です。

以下のコードでは、1つのDateTimePickerで日付と時刻を選択する方法を示しています。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // DateTimePickerのフォーマットをカスタムに設定
        dateTimePicker1.Format = DateTimePickerFormat.Custom;
        dateTimePicker1.CustomFormat = "yyyy年MM月dd日 HH:mm"; // 日付と時刻を同時に表示
    }
}

このコードでは、CustomFormatプロパティを使用して、日付と時刻を同時に表示するカスタムフォーマットを設定しています。

これにより、ユーザーは1つのコントロールで日付と時刻を選択できます。

日付の自動更新

DateTimePickerを使用して、特定の条件に基づいて日付を自動的に更新することができます。

以下のコードでは、ボタンをクリックすると、DateTimePickerの値を現在の日付に更新する方法を示しています。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
    }
    private void buttonUpdate_Click(object sender, EventArgs e)
    {
        // DateTimePickerの値を現在の日付に更新
        dateTimePicker1.Value = DateTime.Now; // 現在の日付と時刻を設定
    }
}