DateTime Estructura

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Source:

DateTime.cs

Representa un instante de tiempo, normalmente expresado en forma de fecha y hora del día.

public value class DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IParsable<DateTime>, ISpanFormattable, ISpanParsable<DateTime>, IUtf8SpanFormattable, System::Runtime::Serialization::ISerializable

public readonly struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IParsable<DateTime>, ISpanFormattable, ISpanParsable<DateTime>, IUtf8SpanFormattable, System.Runtime.Serialization.ISerializable

type DateTime = struct
    interface IConvertible
    interface IFormattable
    interface IParsable<DateTime>
    interface ISpanFormattable
    interface ISpanParsable<DateTime>
    interface ISerializable
    interface IUtf8SpanFormattable

Public Structure DateTime
Implements IComparable, IComparable(Of DateTime), IConvertible, IEquatable(Of DateTime), IParsable(Of DateTime), ISerializable, ISpanFormattable, ISpanParsable(Of DateTime), IUtf8SpanFormattable

Herencia

Object

ValueType

DateTime

Implementaciones

IComparable IComparable<DateTime> IConvertible IEquatable<DateTime> IFormattable ISerializable ISpanFormattable IParsable<DateTime> IParsable<TSelf> ISpanParsable<DateTime> IUtf8SpanFormattable

Comentarios

Para obtener más información sobre esta API, consulte Comentarios complementarios de la API para DateTime.

Constructores

DateTime(DateOnly, TimeOnly)	Inicializa una nueva instancia de la DateTime estructura en los valores y TimeOnlyespecificadosDateOnly. La nueva instancia tendrá el Unspecified tipo .
DateTime(DateOnly, TimeOnly, DateTimeKind)	Inicializa una nueva instancia de la DateTime estructura en el especificado DateOnly y TimeOnly respetando el especificado DateTimeKind.
DateTime(Int32, Int32, Int32)	Inicializa una nueva instancia de la estructura DateTime en el año, mes y día especificados.
DateTime(Int32, Int32, Int32, Calendar)	Inicializa una nueva instancia de la estructura DateTime en el año, mes y día especificados para el calendario determinado.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32)	Inicializa una nueva instancia de la estructura DateTime en el año, mes, día, hora, minuto y segundo especificados.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Calendar)	Inicializa una nueva instancia de la estructura DateTime en el año, mes, día, hora, minuto y segundo especificados para el calendario indicado.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)	Inicializa una nueva instancia de la estructura DateTime en el año, mes, día, hora, minuto, segundo y hora universal coordinada (UTC) u hora local especificados.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Inicializa una nueva instancia de la estructura DateTime en el año, mes, día, hora, minuto, segundo y milisegundo especificados.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar)	Inicializa una nueva instancia de la estructura DateTime en el año, mes, día, hora, minuto, segundo y milisegundo especificados para el calendario indicado.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, DateTimeKind)	Inicializa una nueva instancia de la estructura DateTime en el año, mes, día, hora, minuto, segundo, milisegundo, y hora universal coordinada (UTC) u hora local especificados para el calendario indicado.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)	Inicializa una nueva instancia de la estructura DateTime en el año, mes, día, hora, minuto, segundo, milisegundo y hora universal coordinada (UTC) u hora local especificados.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Inicializa una nueva instancia de la estructura DateTime en el año, mes, día, hora, minuto, segundo, milisegundo, y hora universal coordinada (UTC) u hora local especificados para el calendario indicado.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar)	Inicializa una nueva instancia de la estructura DateTime en el año, mes, día, hora, minuto, segundo, milisegundo, y hora universal coordinada (UTC) u hora local especificados para el calendario indicado.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, DateTimeKind)	Inicializa una nueva instancia de la estructura DateTime en el año, mes, día, hora, minuto, segundo, milisegundo, y hora universal coordinada (UTC) u hora local especificados para el calendario indicado.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)	Inicializa una nueva instancia de la estructura DateTime en el año, mes, día, hora, minuto, segundo, milisegundo, y hora universal coordinada (UTC) u hora local especificados para el calendario indicado.
DateTime(Int64)	Inicializa una nueva instancia de la estructura DateTime en un número de pasos especificado.
DateTime(Int64, DateTimeKind)	Inicializa una nueva instancia de la estructura DateTime en el número de pasos y hora universal coordinada (UTC) u hora local especificados.

Campos

MaxValue	Representa el mayor valor posible de DateTime. Este campo es de solo lectura.
MinValue	Representa el menor valor posible de DateTime. Este campo es de solo lectura.
UnixEpoch	El valor de esta constante es equivalente a 00:00:00.0000000 UTC, 1 de enero de 1970, en el calendario gregoriano. UnixEpoch define el momento dado en el que la hora de Unix es igual a 0.

Propiedades

Date	Obtiene el componente correspondiente a la fecha de esta instancia.
Day	Obtiene el día del mes representado por esta instancia.
DayOfWeek	Obtiene el día de la semana representado por esta instancia.
DayOfYear	Obtiene el día del año representado por esta instancia.
Hour	Obtiene el componente correspondiente a la hora de la fecha representada por esta instancia.
Kind	Obtiene un valor que indica si la hora representada por esta instancia está basada en la hora local, en la hora universal coordinada (UTC), o en ninguna de ellas.
Microsecond	Componente microsegundos, expresado como un valor entre 0 y 999.
Millisecond	Obtiene el componente correspondiente a los milisegundos de la fecha representada por esta instancia.
Minute	Obtiene el componente correspondiente a los minutos de la fecha representada por esta instancia.
Month	Obtiene el componente correspondiente al mes de la fecha representada por esta instancia.
Nanosecond	Componente nanosegundos, expresado como un valor entre 0 y 900 (en incrementos de 100 nanosegundos).
Now	Obtiene un objeto DateTime que se establece en la fecha y hora actual de este equipo, expresada como hora local.
Second	Obtiene el componente correspondiente a los segundos de la fecha representada por esta instancia.
Ticks	Obtiene el número de pasos que representan la fecha y hora de esta instancia.
TimeOfDay	Obtiene la hora del día para esta instancia.
Today	Obtiene la fecha actual.
UtcNow	Obtiene un objeto DateTime que se establece en la fecha y hora actual del equipo, expresada como hora universal coordinada (UTC).
Year	Obtiene el componente correspondiente al año de la fecha representada por esta instancia.

Métodos

Add(TimeSpan)	Devuelve un nuevo objeto DateTime que suma el valor del objeto TimeSpan especificado al valor de esta instancia.
AddDays(Double)	Devuelve un nuevo objeto DateTime que suma el número especificado de días al valor de esta instancia.
AddHours(Double)	Devuelve un nuevo objeto DateTime que suma el número especificado de horas al valor de esta instancia.
AddMicroseconds(Double)	Devuelve un nuevo DateTime objeto que agrega el número especificado de microsegundos al valor de esta instancia.
AddMilliseconds(Double)	Devuelve un nuevo objeto DateTime que suma el número especificado de milisegundos al valor de esta instancia.
AddMinutes(Double)	Devuelve un nuevo objeto DateTime que suma el número especificado de minutos al valor de esta instancia.
AddMonths(Int32)	Devuelve un nuevo objeto DateTime que suma el número especificado de meses al valor de esta instancia.
AddSeconds(Double)	Devuelve un nuevo objeto DateTime que suma el número especificado de segundos al valor de esta instancia.
AddTicks(Int64)	Devuelve un nuevo objeto DateTime que suma el número especificado de pasos al valor de esta instancia.
AddYears(Int32)	Devuelve un nuevo objeto DateTime que suma el número especificado de años al valor de esta instancia.
Compare(DateTime, DateTime)	Compara dos instancias de DateTime y devuelve un entero que indica si la primera instancia es anterior, igual o posterior a la segunda instancia.
CompareTo(DateTime)	Compara el valor de esta instancia con un valor de DateTime especificado y devuelve un entero que indica si esta instancia es anterior, igual o posterior al valor de DateTime especificado.
CompareTo(Object)	Compara el valor de esta instancia con un objeto especificado que contiene un valor de DateTime especificado y devuelve un entero que indica si esta instancia es anterior, igual o posterior al valor de DateTime especificado.
DaysInMonth(Int32, Int32)	Devuelve el número de días del mes y año especificados.
Deconstruct(DateOnly, TimeOnly)	Deconstruye esta DateTime instancia por DateOnly y TimeOnly.
Deconstruct(Int32, Int32, Int32)	Deconstruye esta DateOnly instancia por Year, Monthy Day.
Equals(DateTime)	Devuelve un valor que indica si el valor de esta instancia equivale al valor de la instancia de DateTime especificada.
Equals(DateTime, DateTime)	Devuelve un valor que indica si dos DateTime instancias tienen el mismo valor de fecha y hora.
Equals(Object)	Devuelve un valor que indica si esta instancia equivale a un objeto especificado.
FromBinary(Int64)	Deserializa un valor binario de 64 bits y vuelve a crear un objeto DateTime serializado original.
FromFileTime(Int64)	Convierte la hora de archivo de Windows especificada en una hora local equivalente.
FromFileTimeUtc(Int64)	Convierte la hora de archivo de Windows especificada en una hora UTC equivalente.
FromOADate(Double)	Devuelve un DateTime que equivale a la fecha de automatización OLE especificada.
GetDateTimeFormats()	Convierte el valor de esta instancia en todas las representaciones de cadena admitidas por los especificadores de formato de fecha y hora estándar.
GetDateTimeFormats(Char)	Convierte el valor de esta instancia en todas las representaciones de cadena admitidas por el especificador de formato de fecha y hora estándar indicado.
GetDateTimeFormats(Char, IFormatProvider)	Convierte el valor de esta instancia en todas las representaciones de cadena admitidas por el especificador de formato de fecha y hora estándar y la información de formato específica de la referencia cultural especificados.
GetDateTimeFormats(IFormatProvider)	Convierte el valor de esta instancia en todas las representaciones de cadena admitidas por los especificadores de formato de fecha y hora estándar y la información de formato específica de la referencia cultural especificada.
GetHashCode()	Devuelve el código hash de esta instancia.
GetTypeCode()	Devuelve el TypeCode para el tipo de valor DateTime.
IsDaylightSavingTime()	Indica si esta instancia de DateTime está dentro del intervalo del horario de verano de la zona horaria actual.
IsLeapYear(Int32)	Devuelve una indicación en la que se precisa si el año especificado es bisiesto.
Parse(ReadOnlySpan<Char>, IFormatProvider)	Analiza un intervalo de caracteres en un valor.
Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)	Convierte un intervalo de memoria que contiene una representación de cadena de una fecha y hora en el objeto DateTime equivalente mediante la información de formato específica de la referencia cultural y un estilo de formato especificados.
Parse(String)	Convierte la representación de cadena de una fecha y hora en su DateTime equivalente mediante las convenciones de la referencia cultural actual.
Parse(String, IFormatProvider)	Convierte la representación de cadena para una fecha y hora en su DateTime equivalente, usando la información de formato específica de la referencia cultural especificada.
Parse(String, IFormatProvider, DateTimeStyles)	Convierte la representación de cadena de una fecha y hora en el objeto DateTime equivalente, usando la información de formato específica de la referencia cultural y un estilo de formato especificados.
ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)	Convierte la representación de intervalo especificada de una fecha y hora en su valor DateTime equivalente, mediante el formato, la información de formato específica de la referencia cultural y el estilo especificados. El formato de la representación de cadena debe coincidir exactamente con el formato especificado; de lo contrario, se produce una excepción.
ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles)	Convierte la representación de intervalo especificada de una fecha y hora en su valor DateTime equivalente, mediante la matriz especificada de formatos, información de formato específica de la referencia cultural y estilo. El formato de la representación de cadena debe coincidir exactamente con, al menos, uno de los formatos especificados; de lo contrario se produce una excepción.
ParseExact(String, String, IFormatProvider)	Convierte la representación de cadena especificada de una fecha y hora en el objeto DateTime equivalente, usando la información de formato específica de la referencia cultural y el formato que se hayan especificado. El formato de la representación de cadena debe coincidir exactamente con el formato especificado.
ParseExact(String, String, IFormatProvider, DateTimeStyles)	Convierte la representación de cadena especificada de una fecha y hora en el objeto DateTime equivalente, usando el formato, la información de formato específica de la referencia cultural y el estilo especificados. El formato de la representación de cadena debe coincidir exactamente con el formato especificado; de lo contrario, se produce una excepción.
ParseExact(String, String[], IFormatProvider, DateTimeStyles)	Convierte la representación de cadena especificada de una fecha y hora en el objeto DateTime equivalente, usando la matriz de formatos, la información de formato específica de la referencia cultural y el estilo especificados. El formato de la representación de cadena debe coincidir exactamente con, al menos, uno de los formatos especificados; de lo contrario se produce una excepción.
SpecifyKind(DateTime, DateTimeKind)	Crea un nuevo objeto DateTime que tiene el mismo número de pasos que el objeto DateTime especificado, pero en hora local, en hora universal coordinada (UTC) o en ninguna de ellas, según indique el valor de DateTimeKind especificado.
Subtract(DateTime)	Devuelve un nuevo objeto TimeSpan que resta la fecha y hora especificadas del valor de esta instancia.
Subtract(TimeSpan)	Devuelve un nuevo objeto DateTime que resta la duración especificada del valor de esta instancia.
ToBinary()	Serializa el objeto DateTime actual a un valor binario de 64 bits que se puede usar después para volver a crear el objeto DateTime.
ToFileTime()	Convierte el valor del objeto DateTime actual en una hora de archivo de Windows.
ToFileTimeUtc()	Convierte el valor del objeto DateTime actual en una hora de archivo de Windows.
ToLocalTime()	Convierte el valor del objeto DateTime actual a la hora local.
ToLongDateString()	Convierte el valor del objeto DateTime actual en su representación de cadena de fecha larga equivalente.
ToLongTimeString()	Convierte el valor del objeto DateTime actual en su representación de cadena de hora larga equivalente.
ToOADate()	Convierte el valor de esta instancia en la fecha de Automation OLE equivalente.
ToShortDateString()	Convierte el valor del objeto DateTime actual en su representación de cadena de fecha corta equivalente.
ToShortTimeString()	Convierte el valor del objeto DateTime actual en su representación de cadena de hora corta equivalente.
ToString()	Convierte el valor del objeto DateTime actual en su representación de cadena equivalente mediante las convenciones de formato de la referencia cultural actual.
ToString(IFormatProvider)	Convierte el valor del objeto DateTime actual en su representación de cadena equivalente usando la información de formato específica de la referencia cultural especificada.
ToString(String)	Convierte el valor del objeto DateTime actual en su representación de cadena equivalente mediante el formato especificado y las convenciones de formato de la referencia cultural actual.
ToString(String, IFormatProvider)	Convierte el valor del objeto DateTime actual en la representación de cadena equivalente usando el formato y la información de formato específica de la referencia cultural especificados.
ToUniversalTime()	Convierte el valor del objeto DateTime actual a la hora universal coordinada (UTC).
TryFormat(Span<Byte>, Int32, ReadOnlySpan<Char>, IFormatProvider)	Intenta dar formato al valor de la instancia actual como UTF-8 en el intervalo de bytes proporcionado.
TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)	Intenta dar formato al valor de la instancia de fecha y hora actual en el intervalo de caracteres proporcionado.
TryParse(ReadOnlySpan<Char>, DateTime)	Convierte el intervalo de caracteres especificado de una fecha y hora en su valor DateTime equivalente y devuelve un valor que indica si la conversión se ha realizado correctamente.
TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTime)	Intenta analizar un intervalo de caracteres en un valor.
TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime)	Convierte la representación de intervalo de una fecha y hora en su valor DateTime equivalente mediante la información de formato de la referencia cultural y el estilo de formato especificados, y devuelve un valor que indica si la conversión se ha realizado correctamente.
TryParse(String, DateTime)	Convierte la representación de cadena especificada de una fecha y hora en el objeto DateTime equivalente y devuelve un valor que indica si la conversión se realizó correctamente.
TryParse(String, IFormatProvider, DateTime)	Intenta analizar una cadena en un valor.
TryParse(String, IFormatProvider, DateTimeStyles, DateTime)	Convierte la representación de cadena especificada de una fecha y hora en su equivalente DateTime usando la información de formato de la referencia cultural y el estilo de formato especificados, y devuelve un valor que indica si la conversión tuvo éxito.
TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime)	Convierte la representación de intervalo especificada de una fecha y hora en su valor DateTime equivalente, mediante el formato, la información de formato específica de la referencia cultural y el estilo especificados. El formato de la representación de cadena debe coincidir exactamente con el formato especificado. El método devuelve un valor que indica si la conversión se realizó correctamente.
TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTime)	Convierte el intervalo de caracteres especificado de una fecha y hora en su valor DateTime equivalente y devuelve un valor que indica si la conversión se ha realizado correctamente.
TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime)	Convierte la representación de cadena especificada de una fecha y hora en el objeto DateTime equivalente, usando el formato, la información de formato específica de la referencia cultural y el estilo especificados. El formato de la representación de cadena debe coincidir exactamente con el formato especificado. El método devuelve un valor que indica si la conversión se realizó correctamente.
TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime)	Convierte la representación de cadena especificada de una fecha y hora en el objeto DateTime equivalente, usando la matriz de formatos, la información de formato específica de la referencia cultural y el estilo especificados. El formato de la representación de cadena debe coincidir exactamente con al menos uno de los formatos especificados. El método devuelve un valor que indica si la conversión se realizó correctamente.

Operadores

Addition(DateTime, TimeSpan)	Agrega un intervalo de tiempo especificado a una fecha y hora especificadas, generando una fecha y hora nuevas.
Equality(DateTime, DateTime)	Determina si dos instancias especificadas de DateTime son iguales.
GreaterThan(DateTime, DateTime)	Determina si un DateTime especificado es posterior a otro DateTime especificado.
GreaterThanOrEqual(DateTime, DateTime)	Determina si un DateTime especificado representa una fecha y hora que es el igual o posterior a otro DateTime especificado.
Inequality(DateTime, DateTime)	Determina si dos instancias especificadas de DateTime no son iguales.
LessThan(DateTime, DateTime)	Determina si un DateTime especificado es anterior a otro DateTime especificado.
LessThanOrEqual(DateTime, DateTime)	Determina si un DateTime especificado representa una fecha y hora que es el igual o anterior a otro DateTime especificado.
Subtraction(DateTime, DateTime)	Resta una fecha y hora especificadas de otra fecha y hora especificadas y devuelve un intervalo de tiempo.
Subtraction(DateTime, TimeSpan)	Resta un intervalo de tiempo especificado de un valor de fecha y hora especificado y devuelve un nuevo valor de fecha y hora.

Implementaciones de interfaz explícitas

IConvertible.ToBoolean(IFormatProvider)	No se admite esta conversión. Cualquier intento de usar este método produce una excepción InvalidCastException.
IConvertible.ToByte(IFormatProvider)	No se admite esta conversión. Cualquier intento de usar este método produce una excepción InvalidCastException.
IConvertible.ToChar(IFormatProvider)	No se admite esta conversión. Cualquier intento de usar este método produce una excepción InvalidCastException.
IConvertible.ToDateTime(IFormatProvider)	Devuelve el objeto DateTime actual.
IConvertible.ToDecimal(IFormatProvider)	No se admite esta conversión. Cualquier intento de usar este método produce una excepción InvalidCastException.
IConvertible.ToDouble(IFormatProvider)	No se admite esta conversión. Cualquier intento de usar este método produce una excepción InvalidCastException.
IConvertible.ToInt16(IFormatProvider)	No se admite esta conversión. Cualquier intento de usar este método produce una excepción InvalidCastException.
IConvertible.ToInt32(IFormatProvider)	No se admite esta conversión. Cualquier intento de usar este método produce una excepción InvalidCastException.
IConvertible.ToInt64(IFormatProvider)	No se admite esta conversión. Cualquier intento de usar este método produce una excepción InvalidCastException.
IConvertible.ToSByte(IFormatProvider)	No se admite esta conversión. Cualquier intento de usar este método produce una excepción InvalidCastException.
IConvertible.ToSingle(IFormatProvider)	No se admite esta conversión. Cualquier intento de usar este método produce una excepción InvalidCastException.
IConvertible.ToType(Type, IFormatProvider)	Convierte el objeto DateTime actual en un objeto de un tipo especificado.
IConvertible.ToUInt16(IFormatProvider)	No se admite esta conversión. Cualquier intento de usar este método produce una excepción InvalidCastException.
IConvertible.ToUInt32(IFormatProvider)	No se admite esta conversión. Cualquier intento de usar este método produce una excepción InvalidCastException.
IConvertible.ToUInt64(IFormatProvider)	No se admite esta conversión. Cualquier intento de usar este método produce una excepción InvalidCastException.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Rellena un objeto SerializationInfo con los datos necesarios para serializar el objeto DateTime actual.

Seguridad para subprocesos

Todos los miembros de este tipo son seguros para subprocesos. Los miembros que parecen modificar el estado de instancia devuelven realmente una nueva instancia inicializada con el nuevo valor. Al igual que con cualquier otro tipo, leer y escribir en una variable compartida que contenga una instancia de este tipo debe estar protegida por un bloqueo para garantizar la seguridad de los subprocesos.

Consulte también

• DateTimeOffset
• TimeSpan
• Calendar
• GetUtcOffset(DateTime)
• TimeZoneInfo
• Elección entre DateTime, DateTimeOffset, TimeSpan y TimeZoneInfo
• Trabajar con calendarios
• Ejemplo: Utilidad de formato WinForms de .NET Core (C#)
• Ejemplo: Utilidad de formato WinForms de .NET Core (Visual Basic)