Leer en inglés

Compartir a través de


DateTime Estructura

Definición

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

C#
public struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable
C#
public readonly struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System.Runtime.Serialization.ISerializable
C#
public readonly struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, ISpanFormattable, System.Runtime.Serialization.ISerializable
C#
public readonly struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IParsable<DateTime>, ISpanFormattable, ISpanParsable<DateTime>, System.Runtime.Serialization.ISerializable
C#
public readonly struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IParsable<DateTime>, ISpanFormattable, ISpanParsable<DateTime>, IUtf8SpanFormattable, System.Runtime.Serialization.ISerializable
C#
public struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System.Runtime.Serialization.ISerializable
C#
[System.Serializable]
public struct DateTime : IComparable, IConvertible, IFormattable
C#
[System.Serializable]
public struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System.Runtime.Serialization.ISerializable
C#
public struct DateTime : IComparable, IComparable<DateTime>, IEquatable<DateTime>, IFormattable
Herencia
DateTime
Atributos
Implementaciones

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

IComparable.CompareTo(Object)

Compara la instancia actual con otro objeto del mismo tipo y devuelve un entero que indica si la posición de la instancia actual es anterior, posterior o igual que la del otro objeto en el criterio de ordenación.

IConvertible.GetTypeCode()

Devuelve el TypeCode para esta instancia.

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.

Se aplica a

Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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