Esta documentación está archivada y no tiene mantenimiento.

DateTimePicker (Clase)

Actualización: noviembre 2007

Representa un control de Windows que permite al usuario seleccionar una fecha y una hora, y mostrarlas con un formato especificado.

Espacio de nombres:  System.Windows.Forms
Ensamblado:  System.Windows.Forms (en System.Windows.Forms.dll)

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
[DefaultBindingPropertyAttribute("Value")]
[ComVisibleAttribute(true)]
public class DateTimePicker : Control
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */
/** @attribute DefaultBindingPropertyAttribute("Value") */
/** @attribute ComVisibleAttribute(true) */
public class DateTimePicker extends Control
public class DateTimePicker extends Control

El control DateTimePicker se utiliza para permitir al usuario seleccionar una fecha y una hora, y mostrarlas en el formato especificado. Es posible limitar las fechas y las horas que se pueden seleccionar al establecer las propiedades MinDate y MaxDate.

Para cambiar la presentación de la parte del control que corresponde al calendario, establezca las propiedades CalendarForeColor, CalendarFont, CalendarTitleBackColor, CalendarTitleForeColor, CalendarTrailingForeColor y CalendarMonthBackground.

La propiedad Format establece la clase DateTimePickerFormat del control. La propiedad Format predeterminada de la fecha es DateTimePickerFormat.Long. Si la propiedad Format se establece en DateTimePickerFormat.Custom, se puede crear un estilo de formato propio mediante el establecimiento de la propiedad CustomFormat y la construcción de una cadena de formato personalizado. La cadena de formato personalizado puede ser una combinación de caracteres de campos personalizados y de otros literales de cadena. Por ejemplo, se puede presentar la fecha como "June 01, 2001 - Friday" al establecer la propiedad CustomFormat en "MMMM dd, yyyy - dddd". Para obtener más información, vea Cadenas de formato de fecha y hora.

Si desea utilizar un control de botón de número (también conocido como control de flechas) para ajustar el valor de fecha y hora, establezca la propiedad ShowUpDown en true. El control de calendario no se desplegará cuando se seleccione el control. Para ajustar la fecha y la hora, se puede seleccionar cada elemento por separado y utilizar los botones de flecha arriba y abajo para cambiar el valor.

Si se necesita aplicar un formato de fecha personalizado (por ejemplo, limitando la selección a una sola fecha), se puede utilizar un control DateTimePicker en lugar de un MonthCalendar. Al utilizar DateTimePicker, se limitará la necesidad de validar muchos datos de valores de fecha y hora.

z1b6077x.alert_note(es-es,VS.90).gifNota:

El control DateTimePicker sólo admite calendarios gregorianos.

z1b6077x.alert_caution(es-es,VS.90).gifPrecaución:

Cuando un objeto DateTimePicker está enlazado a datos y el valor de respaldo se cambia a null, no se actualizará el valor del objeto DateTimePicker conservándose el valor anterior. En los casos en los que no se desee este comportamiento (por ejemplo, cuando se usa un conjunto de controles enlazados a datos para paginar un conjunto de registros) use el evento Format de la clase Binding para establecer el valor de DateTimePicker en un valor que se pueda reconocer como null.

En el ejemplo de código siguiente se crea una nueva instancia de un control DateTimePicker y se inicializa. Se establece la propiedad CustomFormat del control. Además, la propiedad ShowCheckBox se establece de tal forma que el control muestra una CheckBox, y la propiedad ShowUpDown se establece de modo que el control se muestre en un control de botón de número (también conocido como control de flechas). Para ejecutar este ejemplo, pegue el código siguiente en un formulario y llame al método CreateMyDateTimePicker en el constructor del formulario del ejemplo o el método de control del evento Load.

public void CreateMyDateTimePicker()
{
   // Create a new DateTimePicker control and initialize it.
   DateTimePicker dateTimePicker1 = new DateTimePicker();

   // Set the MinDate and MaxDate.
   dateTimePicker1.MinDate = new DateTime(1985, 6, 20);
   dateTimePicker1.MaxDate = DateTime.Today;

   // Set the CustomFormat string.
   dateTimePicker1.CustomFormat = "MMMM dd, yyyy - dddd";
   dateTimePicker1.Format = DateTimePickerFormat.Custom;

   // Show the CheckBox and display the control as an up-down control.
   dateTimePicker1.ShowCheckBox = true;
   dateTimePicker1.ShowUpDown = true;
}



public void CreateMyDateTimePicker()
{
    // Create a new DateTimePicker control and initialize it.
    DateTimePicker dateTimePicker1 = new DateTimePicker();

    // Set the MinDate and MaxDate.
    dateTimePicker1.set_MinDate(new DateTime(1985, 6, 20));
    dateTimePicker1.set_MaxDate(DateTime.get_Today());

    // Set the CustomFormat string.
    dateTimePicker1.set_CustomFormat("MMMM dd, yyyy - dddd");
    dateTimePicker1.set_Format(DateTimePickerFormat.Custom);

    // Show the CheckBox and display the control as an up-down control.
    dateTimePicker1.set_ShowCheckBox(true);
    dateTimePicker1.set_ShowUpDown(true);
} //CreateMyDateTimePicker


Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 3.5, 2.0
Mostrar: