DateTimePicker.CustomFormat DateTimePicker.CustomFormat DateTimePicker.CustomFormat DateTimePicker.CustomFormat Property

Definición

Obtiene o establece la cadena de formato personalizado de fecha y hora.Gets or sets the custom date/time format string.

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

Valor de propiedad

Cadena que representa el formato personalizado de fecha y hora.A string that represents the custom date/time format. De manera predeterminada, es null.The default is null.

Ejemplos

El siguiente ejemplo de código establece la CustomFormat propiedad para que el DateTimePicker mostrará la fecha como "June 01, 2001 - Friday".The following code example sets the CustomFormat property so that the DateTimePicker will display the date as "June 01, 2001 - Friday". Este código supone que una instancia de un DateTimePicker se ha creado el control en un Form.This code assumes that an instance of a DateTimePicker control has been created on a 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 'SetMyCustomFormat

Comentarios

Para mostrar los literales de cadena que contienen los separadores de fecha y hora o las cadenas de formato, debe utilizar caracteres de escape en la subcadena.To display string literals that contain date and time separators or to format strings, you must use escape characters in the substring. Por ejemplo, para mostrar la fecha como "El 15 de junio a las 12:00 P.M.", establezca el CustomFormat propiedad en "MMMM dd 'at' t: mm tt".For example, to display the date as "June 15 at 12:00 PM", set the CustomFormat property to "MMMM dd 'at' t:mm tt". Si la subcadena "en" no está entre caracteres de escape, el resultado es "el 15 de junio aP 12:00 P.M." porque el carácter "t" es de lectura como la a.m. y una sola letra.If the "at" substring is not enclosed by escape characters, the result is "June 15 aP 12:00PM" because the "t" character is read as the one-letter A.M./P.M. cadena de formato (vea la tabla de cadenas de formato a continuación).format string (see the format string table below).

Las cadenas de formato se pueden combinar para dar formato a la fecha y hora.The format strings can be combined to format the date and time. Por ejemplo, para mostrar la fecha y hora como 06/15/2001 12:00 PM, esta propiedad debe establecerse en "MM '/' dd '/' aaaa hh': ' mm tt".For example, to display the date and time as 06/15/2001 12:00 PM, this property should be set to "MM'/'dd'/'yyyy hh':'mm tt". Para obtener más información, consulte Custom Date and Time Format Strings.For more information, see Custom Date and Time Format Strings.

Nota

El Format propiedad debe establecerse en DateTimePickerFormat.Custom para esta propiedad influir en el formato de la fecha y hora mostradas.The Format property must be set to DateTimePickerFormat.Custom for this property to affect the formatting of the displayed date and time.

En la tabla siguiente se enumera todas las cadenas de formato válidos y sus descripciones.The following table lists all the valid format strings and their descriptions.

Cadena de formatoFormat string DescripciónDescription
dd El día de uno o dos dígitos.The one- or two-digit day.
dddd El día de dos dígitos.The two-digit day. Los valores de día de un solo dígito van precedidos por un 0.Single-digit day values are preceded by a 0.
dddddd La abreviatura del día de la semana de tres caracteres.The three-character day-of-week abbreviation.
dddddddd El nombre completo de día de semana.The full day-of-week name.
hh La hora de uno o dos dígitos en formato de 12 horas.The one- or two-digit hour in 12-hour format.
hhhh La hora de dos dígitos en formato de 12 horas.The two-digit hour in 12-hour format. Los valores de un solo dígito van precedidos de un 0.Single digit values are preceded by a 0.
HH La hora de uno o dos dígitos en formato de 24 horas.The one- or two-digit hour in 24-hour format.
HHHH La hora de dos dígitos en formato de 24 horas.The two-digit hour in 24-hour format. Los valores de un solo dígito van precedidos de un 0.Single digit values are preceded by a 0.
mm El minuto de uno o dos dígitos.The one- or two-digit minute.
mmmm El minuto de dos dígitos.The two-digit minute. Los valores de un solo dígito van precedidos de un 0.Single digit values are preceded by a 0.
MM El número de mes de uno o dos dígitos.The one- or two-digit month number.
MMMM El número del mes de dos dígitos.The two-digit month number. Los valores de un solo dígito van precedidos de un 0.Single digit values are preceded by a 0.
MMMMMM La abreviatura del mes de tres caracteres.The three-character month abbreviation.
MMMMMMMM El nombre completo del mes.The full month name.
ss Los segundos de uno o dos dígitos.The one- or two-digit seconds.
ssss El segundo de dos dígitos.The two-digit seconds. Los valores de un solo dígito van precedidos de un 0.Single digit values are preceded by a 0.
mt El AM/PM de una sola letra.The one-letter A.M./P.M. abreviatura de (a. M.abbreviation (A.M. se muestra como "A").is displayed as "A").
tttt El AM/PM de dos letras.The two-letter A.M./P.M. abreviatura de (a. M.abbreviation (A.M. se muestra como "AM").is displayed as "AM").
yy El año de un dígito (2001 se muestra como "1").The one-digit year (2001 is displayed as "1").
yyyy Los dos últimos dígitos del año (2001 se muestra como "01").The last two digits of the year (2001 is displayed as "01").
yyyyyyyy Todo el año (2001 se muestra como "2001").The full year (2001 is displayed as "2001").

Se aplica a

Consulte también: