Compartir a través de

DateTimePicker.CustomFormat Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

Obtiene o establece la cadena de formato personalizado de fecha y hora.

public:
 property System::String ^ CustomFormat { System::String ^ get(); void set(System::String ^ value); };
public string CustomFormat { get; set; }
public string? CustomFormat { get; set; }
member this.CustomFormat : string with get, set
Public Property CustomFormat As String

Valor de propiedad

String

Cadena que representa el formato personalizado de fecha y hora. De manera predeterminada, es null.

Ejemplos

En el ejemplo de código siguiente se establece la CustomFormat propiedad para que DateTimePicker muestre la fecha como "1 de junio de 2001 - viernes". Este código supone que se ha creado una instancia de un DateTimePicker control en .Form

public:
   void SetMyCustomFormat()
   {
      // Set the Format type and the CustomFormat string.
      dateTimePicker1->Format = DateTimePickerFormat::Custom;
      dateTimePicker1->CustomFormat = "MMMM dd, yyyy - dddd";
   }

public void SetMyCustomFormat()
{
   // Set the Format type and the CustomFormat string.
   dateTimePicker1.Format = DateTimePickerFormat.Custom;
   dateTimePicker1.CustomFormat = "MMMM dd, yyyy - dddd";
}

Public Sub SetMyCustomFormat()
    ' Set the Format type and the CustomFormat string.
    dateTimePicker1.Format = DateTimePickerFormat.Custom
    dateTimePicker1.CustomFormat = "MMMM dd, yyyy - dddd"
End Sub

Comentarios

Para mostrar literales de cadena que contienen separadores de fecha y hora o para dar formato a cadenas, debe usar caracteres de escape en la subcadena. Por ejemplo, para mostrar la fecha como "15 de junio a las 12:00 p.m.", establezca la CustomFormat propiedad en "MMMM dd 'at' t:mm tt". Si la subcadena "at" no está entre caracteres de escape, el resultado es "June 15 aP 12:00PM" porque el carácter "t" se lee como la cadena de formato A.M./P.M. de una letra (vea la tabla de cadenas de formato siguiente).

Las cadenas de formato se pueden combinar para dar formato a la fecha y hora. Por ejemplo, para mostrar la fecha y hora como 15/06/2001 12:00 p.m., esta propiedad debe establecerse en "MM'/'dd'/'aaaa hh':'mm tt". Para obtener más información, vea Cadenas de formato de fecha y hora personalizadas.

Nota

La Format propiedad debe establecerse DateTimePickerFormat.Custom en para que esta propiedad afecte al formato de la fecha y hora mostradas.

En la tabla siguiente se enumeran todas las cadenas de formato válidas y sus descripciones.

Cadena de formato Descripción
d El día de uno o dos dígitos.
dd Día de dos dígitos. Los valores de día de un solo dígito van precedidos de 0.
ddd Abreviatura de día de la semana de tres caracteres.
dddd Nombre completo del día de la semana.
h Hora de uno o dos dígitos en formato de 12 horas.
hh Hora de dos dígitos en formato de 12 horas. Los valores de un solo dígito van precedidos de 0.
H Hora de uno o dos dígitos en formato de 24 horas.
HH Hora de dos dígitos en formato de 24 horas. Los valores de un solo dígito van precedidos de 0.
m Minuto de uno o dos dígitos.
MM Minuto de dos dígitos. Los valores de un solo dígito van precedidos de 0.
M Número de mes de uno o dos dígitos.
MM Número de mes de dos dígitos. Los valores de un solo dígito van precedidos de 0.
MMM Abreviatura de mes de tres caracteres.
MMMM Nombre completo del mes.
s Segundos de uno o dos dígitos.
ss Segundos de dos dígitos. Los valores de un solo dígito van precedidos de 0.
t La abreviatura A.M./P.M. de una letra (A.M. se muestra como "A").
tt La abreviatura A.M./P.M. de dos letras (A.M. se muestra como "AM").
s El año de un dígito (2001 se muestra como "1").
yy Los dos últimos dígitos del año (2001 se muestran como "01").
aaaa El año completo (2001 se muestra como "2001").

Se aplica a

Consulte también