Partilhar via

Visão geral do controle DateTimePicker (Windows Forms)

  • Artigo

O controle de DateTimePicker do Windows Forms permite que o usuário selecione um único item de uma lista de datas ou horas. Quando usado para representar uma data, ele aparece em duas partes: uma lista suspensa com uma data representada no texto e uma grade que aparece quando você clica na seta para baixo ao lado da lista. A grade se parece com o controle MonthCalendar, que pode ser usado para selecionar várias datas. Para mais informações sobre o controlo MonthCalendar, consulte a descrição geral do controlo MonthCalendar.

Principais propriedades

Se desejar que o DateTimePicker apareça como um controle para selecionar ou editar horários em vez de datas, defina a propriedade ShowUpDown como true e a propriedade Format como Time. Para obter mais informações, consulte Como exibir a hora com o controle DateTimePicker.

Quando a propriedade ShowCheckBox é definida como true, uma caixa de seleção é exibida ao lado da data selecionada no controle. Quando a caixa de seleção estiver marcada, o valor de data-hora selecionado poderá ser atualizado. Quando a caixa de seleção está vazia, o valor aparece indisponível.

As propriedades MaxDate e MinDate do controle determinam o intervalo de datas e horas. A propriedade Value contém a data e hora atuais para as quais o controle está definido. Para obter detalhes, consulte Como definir e retornar datas com o controle DateTimePicker do Windows Forms. Os valores podem ser exibidos em quatro formatos, que são definidos pela propriedade Format: Long, Short, Timeou Custom. Se um formato personalizado for selecionado, você deverá definir a propriedade CustomFormat como uma cadeia de caracteres apropriada. Para obter detalhes, consulte Como exibir uma data em um formato personalizado com o controle DateTimePicker do Windows Forms.

Ver também