DatePicker.DayFormat プロパティ

定義

名前空間:

Microsoft.UI.Xaml.Controls

日の値の表示形式を取得または設定します。

public:
 property Platform::String ^ DayFormat { Platform::String ^ get(); void set(Platform::String ^ value); };

winrt::hstring DayFormat();

void DayFormat(winrt::hstring value);

public string DayFormat { get; set; }

var string = datePicker.dayFormat;
datePicker.dayFormat = string;

Public Property DayFormat As String

<DatePicker DayFormat="formatString"/>

プロパティ値

String

Platform::String

winrt::hstring

日の値の表示形式。

例

形式テンプレートを使用して書式設定された DatePicker と、書式指定文字列を使用して書式設定された DatePicker を次に示します。 どちらの DatePicker コントロールも、書式設定が同等であるため、アプリの実行時に同じように表示されます。

<!-- DatePicker formatted using format templates. -->
<DatePicker DayFormat="day" MonthFormat="month.numeric" YearFormat="year.abbreviated"/>

<!-- DatePicker formatted using format patterns. -->
<DatePicker DayFormat="{}{day.integer}" MonthFormat="{}{month.integer}" YearFormat="{}{year.abbreviated}"/>

ここでは、2 つの書式パターンを組み合わせた DatePicker を使用して、日付と曜日の両方を日の選択ウィンドウに表示します。 この形式に対応する書式テンプレートはありません。

<DatePicker DayFormat="{}{day.integer} {dayofweek.abbreviated}"/>

注釈

プロパティを設定して、日の選択の形式を DayFormat 変更します。

DatePicker の各 ComboBox の文字列コンテンツは、DateTimeFormatter によって作成されます。 日付の値を書式設定する方法を DateTimeFormatter に通知するには、 書式テンプレート または 書式パターンの文字列を指定します。 日の値の一般的なテンプレートとパターンを次の表に示します。

書式パターン	テンプレートの書式設定
'{day.integer} |{day.integer(n)}'	'day'
'{dayofweek.full} |{dayofweek.abbreviated} |{dayofweek.abbreviated(n)}'	'dayofweek |dayofweek.full |dayofweek.abbreviated'

場合によっては、書式パターンを使用すると、書式設定をより正確に制御できます。 たとえば、書式パターンを使用して、日の選択ウィンドウに常に 2 桁の数字 (必要に応じて先頭に 0 を含む) が表示されるように指定できます。 複数の書式パターンを組み合わせることもできます。 たとえば、 と {dayofweek.abbreviated} の形式を組み合わせて{day}、日の選択ウィンドウに数値の日付と曜日の両方を表示できます(例: 14 Thu)。 詳細については、「例」セクションを参照してください。

書式テンプレートと書式パターンの完全な一覧については、 DateTimeFormatter クラスドキュメントの「解説」セクションを参照してください。

注意

日付ピッカーが小さな領域に表示される場合は、曜日の完全な文字列値を追加するなど、一部の日付形式は避ける必要があります。 これらの文字列は長い場合があり、DatePicker の幅を強制的に小さくするとクリップされる可能性があります。

こちらもご覧ください

• MonthFormat
• YearFormat
• DayVisible
• DateTimeFormatter
• 日付の選択コントロール
• テンプレートとパターンを使った日付と時刻の書式設定