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

概要

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

前提・対象環境

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

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

DatePicker に実際に表示される文字列は、設定を変えて読み出せば確かめられる。

.NET 10 / 日本語環境の Windows 11 で、2026-07-17 を選択した DatePicker のテキスト部分を読み取った結果。2 列目の括弧内は、その値がどこから来たかを DependencyPropertyHelper.GetValueSource で読んだものである。

SelectedDateFormat は Short と Long の 2 つしか持たない。 どちらも任意の書式を指定する手段を持たない。
これが、以降で述べる回避方法が必要になる理由である。

何も設定しなければ Short になるが、これは依存関係プロパティのメタデータに登録された既定値ではない。
メタデータの既定値は Long であり、Short は既定スタイルが設定している。表の 2 列目に出ている DefaultStyle がその出どころである。

最終行は、テンプレート内のテキスト部分を直接書き換えた場合である。曜日を含む書式のように、2 つの既定形式では表せない表示もこの方法なら作れる。

本記事の表は、上記の環境で実際に計測したものである。
計測の条件は、それぞれの表の説明に書いた。
この環境で確認しているのは次の点である。

• SelectedDateFormat は Short と Long の 2 つしか持たず、任意の書式にはできない。
• SelectedDateFormat の既定値は Short であり、これは依存関係プロパティのメタデータではなく既定スタイルに由来する。
• テンプレート内のテキスト部分を書き換えれば、任意の書式にできる。

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>

エスケープしない / は日付区切りのプレースホルダーであり、バインドのカルチャによって別の文字に置き換えられるため、リテラルとして描画させるにはエスケープが要る。
ただし、マークアップ拡張の中では \ 自体が XAML のエスケープ文字として扱われる。\/ とだけ書くと XAML のパーサーに \ が消費されて書式は yyyy/MM/dd になり、de-DE では 2026.04.15 と表示される。上の例のように \\/ と重ねると、書式に \/ が残る。
シングルクォートで囲む場合も、StringFormat=yyyy\'/\'MM\'/\'dd のようにクォート自体をエスケープすれば同じ効果が得られる。エスケープしない yyyy'/'MM'/'dd では、XAML の読み込みに失敗した。4 通りの結果は、次の図の後の表に示す。

既定表示のカルチャは、Language(XAML では xml:lang)の値がどこから来ているかで決まる。
自身にも親要素にも指定がなく、値の出どころが既定値(Default)のままであれば、スレッドの CurrentCulture に従う。このとき Language の既定値である en-US は使われない。
自身に指定した場合(Local)も、Window などの親要素の指定を継承した場合(Inherited)も、CurrentCulture に関係なくその言語の形式になる。

SelectedDate を 2026-04-15 とした DatePicker の既定表示（.NET 10 / Windows 11 で実測）。どこにも xml:lang を指定しない行では Language の値の出どころが Default であり、表示は CurrentCulture に従う。自身に指定した行（Local）と、親要素の指定を継承した行（Inherited）では、CurrentCulture を変えても表示が変わらない。

適用前後を並べると次のようになる。
実行マシンの地域設定に左右されないよう、両方に 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>

この書式は、表示した後も保たれる。
xml:lang="de-DE" で表示したあと、コードで SelectedDate を変えても、カレンダーで日付を選んでも、表示は指定どおりの 2026/05/20・2026/06/03 だった。
DatePickerTextBox.Text の値の出どころは、最後までスタイルのバインドのままだった。

.NET 10 / Windows 11 で、本節のスタイルを当てた DatePicker を表示し、日付を 2 回変えて測った結果。値の出どころは DependencyPropertyHelper.GetValueSource で読んだ。

ただし、区切り文字のエスケープで固定できるのは区切り文字と並び順であって、暦そのものではない。区切りが保たれても、th-TH・ar-SA・fa-IR はそれぞれの暦の年と月で表示される。

.NET 10 / Windows 11 で、本節のスタイルをそれぞれの StringFormat と xml:lang で読み込み、SelectedDate を 2026-04-15 にして測った結果。ASCII 以外の文字は符号位置で示している。

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

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

SelectedDateChanged イベントを購読し、整形した文字列を DatePicker.Text に代入する方法がよく紹介される。この方法では表示は変わらない。
SelectedDateChanged が発生した時点で、Text はすでに既定の書式で設定されている。そこへ yyyy/MM/dd の文字列を代入すると、DatePicker はその文字列を日付として解析し、代入の直後に既定の書式の文字列へ直した。ハンドラーの入口でも代入の直後でも、Text は 4/15/2026 だった。

.NET 10 / Windows 11 で、SelectedDate を 2026-04-15 にしたあと、ハンドラーで Text を不変カルチャの yyyy/MM/dd に書き換えて測った結果。

コードから書式を指定したい場合は、XAML による方法と同じ DatePickerTextBox のスタイルとバインドを設定するか、本体の表示はそのままにして、次節のコンバーターで併設表示を整形する。

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

コンバーターは 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 ではスレッドの CurrentCulture である。
バインドの StringFormat では、ConverterCulture を指定すればそのカルチャ、指定しなければ対象要素の Language になる。
後者は、Language が既定値のままなら OS の地域設定ではなく en-US になる(Binding.StringFormat の記事で実測している)。
年 月 日 や -、, などはリテラルとしてそのまま保持される。
マシンの地域設定に関わらず固定レイアウトを保つには、上記のコンバーターのように ToString へ CultureInfo.InvariantCulture を渡すか、yyyy'/'MM'/'dd のように区切りをエスケープする。

注意点

• XAML の StringFormat 方式が変えるのは表示テキストだけである。基となる SelectedDate の値は変わらないため、日付を直接参照するバインドには影響しない。
• コンバーターでは、is DateTime の型の判定が日付未選択の場合を扱っている。null は判定を通らないため整形されない。そのうえで string.Empty を返すと、何も表示されない。

まとめ

最適な方法はプロジェクトのアーキテクチャに依存する。
DatePicker 本体の表示を変えるには Style + StringFormat を使う。SelectedDateChanged で Text を書き換えても表示は変わらなかった。コンバーターは、同じ日付を表示する併設表示が複数ある場合に適する。

• DatePicker（WPF 標準コントロールデモアプリ）：Text がカルチャで解析される様子と、SelectedDateFormat などスタイルから来る既定値を実測したページ