DatePicker.YearFormat Propriedade

Definição

Namespace:

Microsoft.UI.Xaml.Controls

Obtém ou define o formato de exibição para o valor de ano.

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

winrt::hstring YearFormat();

void YearFormat(winrt::hstring value);

public string YearFormat { get; set; }

var string = datePicker.yearFormat;
datePicker.yearFormat = string;

Public Property YearFormat As String

<DatePicker YearFormat="formatString"/>

Valor da propriedade

String

Platform::String

winrt::hstring

O formato de exibição do valor do ano.

Exemplos

Aqui está um DatePicker formatado usando modelos de formato e um DatePicker formatado usando cadeias de caracteres de formato. Ambos os DatePickersão iguais quando o aplicativo é executado porque a formatação é equivalente.

<!-- 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}"/>

Comentários

Altere o formato do seletor de ano definindo a YearFormat propriedade .

O conteúdo da cadeia de caracteres de cada ComboBox no DatePicker é criado por um DateTimeFormatter. Informe ao DateTimeFormatter como formatar o valor de ano fornecendo uma cadeia de caracteres que seja um modelo de formato ou um padrão de formato. Modelos e padrões comuns para valores de ano são listados na tabela a seguir.

padrão de formato	modelo de formato
'{year.full} | {year.abbreviated} | {year.abbreviated(n)}'	'year | year.full | year.abreviado'
'{era.full} | {era.abbreviated} | {era.abbreviated(n)}'	N/D

Observação

"Era" só se aplica quando CalendarIdentifier é definido como o calendário japonês. Para o calendário japonês, era é mostrada no seletor de ano.

Para obter a lista completa de modelos de formato e padrões de formato, consulte a seção Comentários da documentação da classe DateTimeFormatter .

Observação

Alguns formatos de data devem ser evitados se o seletor de datas puder ser exibido em uma área pequena, como adicionar o valor de cadeia de caracteres completo do dia da semana. Essas cadeias de caracteres podem ser longas e podem ser recortadas se a largura do DatePicker for forçada a ser pequena.

Confira também

• DayFormat
• MonthFormat
• YearVisible
• DateTimeFormatter
• Seletor de data