Seletor de dataDate picker

O seletor de data oferece uma maneira padronizada de permitir que os usuários escolham um valor de data localizado usando entrada por toque, mouse ou teclado.The date picker gives you a standardized way to let users pick a localized date value using touch, mouse, or keyboard input.

Exemplo de seletor de data

Obter a biblioteca de interface do usuário do WindowsGet the Windows UI Library

Logotipo do WinUI

A Biblioteca de interface do usuário do Windows 2.2 ou posterior inclui um novo modelo para esse controle que usa cantos arredondados.Windows UI Library 2.2 or later includes a new template for this control that uses rounded corners. Para obter mais informações, confira Raio de canto.For more info, see Corner radius. WinUI é um pacote NuGet que contém novos controles e recursos de interface do usuário para aplicativos do Windows.WinUI is a NuGet package that contains new controls and UI features for Windows apps. Para obter mais informações, incluindo instruções de instalação, confira Biblioteca de interface do usuário do Windows.For more info, including installation instructions, see Windows UI Library.

APIs de plataforma: classe DatePicker, propriedade DatePlatform APIs: DatePicker class, Date property

Esse é o controle correto?Is this the right control?

Use um seletor de data para permitir que um usuário selecione uma data conhecida, como uma data de nascimento, em que o contexto do calendário não é importante.Use a date picker to let a user pick a known date, such as a date of birth, where the context of the calendar is not important.

Para saber mais sobre como escolher o controle de data correto, veja o artigo Controles de data e hora.For more info about choosing the right date control, see the Date and time controls article.

ExemplosExamples

XAML Controls GalleryXAML Controls Gallery
XAML controls gallery

Se você tiver o aplicativo XAML Controls Gallery instalado, clique aqui para abrir o aplicativo e ver o DatePicker em ação.If you have the XAML Controls Gallery app installed, click here to open the app and see the DatePicker in action.

O ponto de entrada mostra a data escolhida e, quando o usuário seleciona o ponto de entrada, uma superfície de seletor se expande verticalmente do meio para que o usuário faça uma seleção.The entry point displays the chosen date, and when the user selects the entry point, a picker surface expands vertically from the middle for the user to make a selection. O seletor de data se sobrepõe à outra interface do usuário; ele não remove a outra interface do usuário.The date picker overlays other UI; it doesn't push other UI out of the way.

Exemplo da expansão do seletor de data

Criar um seletor de dataCreate a date picker

Este exemplo mostra como criar um seletor de data simples com um cabeçalhoThis example shows how to create a simple date picker with a header.

<DatePicker x:Name="birthDatePicker" Header="Date of birth"/>
DatePicker birthDatePicker = new DatePicker();
birthDatePicker.Header = "Date of birth";

O seletor de data resultante tem esta aparência:The resulting date picker looks like this:

Exemplo de seletor de data

Observação  Para obter informações importantes sobre valores de data, confira Valores DateTime e Calendar no artigo sobre os controles de Data e Hora.Note  For important info about date values, see DateTime and Calendar values in the Date and time controls article.

Obter o código de exemploGet the sample code