DatePicker の表示形式をカスタマイズする方法

概要

WPF の DatePicker は、選択された日付をシステムのロケール形式(例: en-US では 4/15/2026)で表示する。
この挙動は、マシンの地域設定に依存せず固定のレイアウトで日付を見せたい場合に不都合となる。
ログ向けの yyyy/MM/dd やレポート向けの dd MMM yyyy などが典型例である。
本記事では、コントロールが常にアプリの要求する形式で日付を表示するようカスタマイズする方法を、XAML スタイル・コードビハインド・バリューコンバーターの 3 通りで比較する。

前提・対象環境

• フレームワーク / 言語: .NET 6 以降 / C# 10
• 対象コントロール: WPF DatePicker(System.Windows.Controls)
• アーキテクチャ: コードビハインド・MVVM のいずれにも適用可能

以下の手法は、既定の DatePicker コントロールテンプレートが視覚ツリーに DatePickerTextBox を含むことに依存する。
テンプレートを全面的に差し替えた DatePicker ではこの要素が公開されない場合があり、その際はコードビハインド方式か、カスタムテンプレート内での整形に頼ることになる。
後述するコンバーターが整形するのは、DatePicker 本体ではなく併設の表示である。

XAML スタイルによる方法

コントロールテンプレート内の DatePickerTextBox をスタイル経由で対象にし、Text プロパティに StringFormat を指定する。

<DatePicker x:Name="datePicker" SelectedDate="{Binding SelectedDate}">
  <DatePicker.Resources>
    <Style TargetType="DatePickerTextBox">
      <Setter Property="Text"
              Value="{Binding SelectedDate,
                              RelativeSource={RelativeSource AncestorType=DatePicker},
                              StringFormat='yyyy\/MM\/dd'}" />
    </Style>
  </DatePicker.Resources>
</DatePicker>

区切り文字は \/ とエスケープしてリテラルとして描画させている。
エスケープしない / は日付区切りのプレースホルダーであり、バインドのカルチャによって別の文字に置き換えられ、固定レイアウトが崩れる。
なお、シングルクォートで囲む '/'(例: yyyy'/'MM'/'dd)でも同じ効果が得られ、記事の後半ではこの記法を用いている。

適用前後を並べると次のようになる。
既定表示はターゲット要素の Language(XAML では xml:lang)に従うため、実行マシンのロケールに左右されないよう両方に en-US を指定している。

<!-- 既定の表示 -->
<DatePicker xml:lang="en-US" SelectedDate="2026-04-15" Width="190" />

<!-- 上のスタイルを適用したもの -->
<DatePicker xml:lang="en-US" SelectedDate="2026-04-15" Width="190">
  <DatePicker.Resources>
    <Style TargetType="DatePickerTextBox">
      <Setter Property="Text"
              Value="{Binding SelectedDate,
                              RelativeSource={RelativeSource AncestorType=DatePicker},
                              StringFormat='yyyy\/MM\/dd'}" />
    </Style>
  </DatePicker.Resources>
</DatePicker>

ただし、\/ のエスケープで固定できるのは区切り文字と並び順であって、暦そのものではない。
同じ yyyy\/MM\/dd をカルチャだけ変えて評価すると次のようになる（.NET 10 での実測値）。

暦まで含めて固定したい場合は、バインドに ConverterCulture を指定してカルチャ自体を固定する。

コードビハインドによる方法

コードビハインドでは、SelectedDateChanged イベントを購読してテキストを手動で整形する。

using System.Globalization;
using System.Windows.Controls;

private void DatePicker_SelectedDateChanged(object sender, SelectionChangedEventArgs e)
{
    if (datePicker.SelectedDate.HasValue)
    {
        datePicker.Text = datePicker.SelectedDate.Value
            .ToString("yyyy/MM/dd", CultureInfo.InvariantCulture);
    }
    else
    {
        datePicker.Text = string.Empty;
    }
}

CultureInfo.InvariantCulture を渡すことで、マシンの地域設定に関わらず区切り文字を固定できる。
これを省いた ToString("yyyy/MM/dd") は現在のカルチャを使うため、/ がそのカルチャの日付区切りに従う。

コンバーターによる併設表示

コンバーターは DatePicker 本体の表示を変えられない。
本体のテキストはコントロールテンプレートが SelectedDate から生成するものであり、バインド値から作られるわけではない。
加えて SelectedDate は DateTime? であるため、文字列を返すコンバーターを直接バインドしても適用されない。
コンバーターが適するのは、同じ日付を選んだ形式で表示する併設のラベルやステータスバーなど、いわゆるコンパニオン表示である。

using System;
using System.Globalization;
using System.Windows;
using System.Windows.Data;

public class DateFormatConverter : IValueConverter
{
    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
        => value is DateTime d ? d.ToString("yyyy/MM/dd", CultureInfo.InvariantCulture) : string.Empty;

    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
        => DateTime.TryParseExact(value as string, "yyyy/MM/dd",
               CultureInfo.InvariantCulture, DateTimeStyles.None, out var d)
            ? d : DependencyProperty.UnsetValue;
}

同じソースにコンバーター経由で TextBlock をバインドする。

<TextBlock Text="{Binding SelectedDate, ElementName=datePicker,
                  Converter={StaticResource DateFormatConverter}}" />

コンバーターは形式文字列を 1 箇所に集約するため、1 回の修正で再利用しているすべての併設表示に反映される。

よく使う書式指定文字列

ToString や StringFormat に渡す書式は、標準の .NET カスタム日時書式指定子に従う。

ここで / と : はリテラルではなく、それぞれ日付区切り・時刻区切りのプレースホルダーであり、ランタイムが現在のカルチャの区切り文字に置き換える(区切りが . のカルチャでは 2026.04.15 となる)。
年 月 日 や -、, などはリテラルとしてそのまま保持される。
マシンの地域設定に関わらず固定レイアウトを保つには、上記のコンバーターのように ToString へ CultureInfo.InvariantCulture を渡すか、yyyy'/'MM'/'dd のように区切りをエスケープする。

注意点

• XAML の StringFormat 方式が変えるのは表示テキストだけである。基となる SelectedDate の値は変わらないため、日付を直接参照するバインドには影響しない。
• SelectedDateChanged 方式は Text プロパティを手動で上書きする。ユーザーがボックスに入力し直したときも双方向の解析が成立する必要があるため、パーサーが往復変換できない形式は避ける。
• 日付未選択のとき string.Empty を返すコンバーターにしておくと、NullReferenceException を防げる。

まとめ

最適な方法はプロジェクトのアーキテクチャに依存する。
DatePicker 本体の表示を変えるには Style + StringFormat かコードビハインドが必要であり、コンバーターは同じ日付を表示する併設表示が複数ある場合に適する。