Compartilhar via


Como exibir uma data em um formato personalizado com o controle DateTimePicker dos Windows Forms

O controle DateTimePicker do Windows Forms oferece flexibilidade na formatação da exibição de datas e horas no controle. A propriedade Format permite que você selecione entre formatos predefinidos, listados no DateTimePickerFormat. Se nenhum deles for adequado para suas finalidades, você poderá criar seu próprio estilo de formato usando caracteres de formato listados em CustomFormat.

Para exibir um formato personalizado

  1. Defina a propriedade Format como DateTimePickerFormat.Custom.

  2. Defina a propriedade CustomFormat como uma cadeia de caracteres de formato.

    DateTimePicker1.Format = DateTimePickerFormat.Custom  
    ' Display the date as "Mon 27 Feb 2012".  
    DateTimePicker1.CustomFormat = "ddd dd MMM yyyy"  
    
    dateTimePicker1.Format = DateTimePickerFormat.Custom;  
    // Display the date as "Mon 27 Feb 2012".  
    dateTimePicker1.CustomFormat = "ddd dd MMM yyyy";  
    
    dateTimePicker1->Format = DateTimePickerFormat::Custom;  
    // Display the date as "Mon 27 Feb 2012".  
    dateTimePicker1->CustomFormat = "ddd dd MMM yyyy";  
    

Para adicionar texto ao valor formatado

  1. Use aspas simples para colocar qualquer caractere que não seja um caractere de formato como "M" ou um delimitador como ":". Por exemplo, a cadeia de caracteres de formato abaixo exibe a data atual com o formato "Hoje é: 05:30:31 Sexta-feira 02 de março de 2012" na cultura em inglês (Estados Unidos).

    DateTimePicker1.CustomFormat = "'Today is:' hh:mm:ss dddd MMMM dd, yyyy"  
    
    dateTimePicker1.CustomFormat = "'Today is:' hh:mm:ss dddd MMMM dd, yyyy";  
    
    dateTimePicker1->CustomFormat =  
       "'Today is:' hh:mm:ss dddd MMMM dd, yyyy";  
    

    Dependendo da configuração de cultura, todos os caracteres não colocados entre aspas simples podem ser alterados. Por exemplo, a cadeia de caracteres de formato acima exibe a data atual com o formato "Hoje é: 05:30:31 Sexta-feira 02 de março de 2012" na cultura em inglês (Estados Unidos). Observe que a primeira vírgula é colocada entre aspas simples, porque não se pretende que ela seja um caractere delimitador como em "hh:mm:ss". Em outra cultura, o formato pode aparecer como "Hoje é: 05.30.31 sexta-feira 02 de março de 2012".

Consulte também