Clase System::DateTime

DateTime class

Representa un valor de fecha y hora específico en el continuo temporal. Este tipo debe ser asignado en la pila y pasado a funciones por valor o por referencia. Nunca use la clase System::SmartPtr para gestionar objetos de este tipo.

class DateTime

Métodos

MétodoDescripción
Add(TimeSpan) constDevuelve una nueva instancia de la clase DateTime que representa un valor de fecha y hora que resulta de la suma del intervalo de tiempo especificado al valor de fecha y hora representado por el objeto actual.
AddDays(double) constDevuelve una nueva instancia de la clase DateTime que representa el valor de fecha y hora que es la suma del valor representado por el objeto actual y el número especificado de días.
AddHours(double) constDevuelve una nueva instancia de la clase DateTime que representa el valor de fecha y hora que es la suma del valor representado por el objeto actual y el número especificado de horas.
AddMilliseconds(double) constDevuelve una nueva instancia de la clase DateTime que representa el valor de fecha y hora que es la suma del valor representado por el objeto actual y el número especificado de milisegundos.
AddMinutes(double) constDevuelve una nueva instancia de la clase DateTime que representa el valor de fecha y hora que es la suma del valor representado por el objeto actual y el número especificado de minutos.
AddMonths(int) constDevuelve una nueva instancia de la clase DateTime que representa el valor de fecha y hora que es la suma del valor representado por el objeto actual y el número especificado de meses.
AddSeconds(double) constDevuelve una nueva instancia de la clase DateTime que representa el valor de fecha y hora que es la suma del valor representado por el objeto actual y el número especificado de segundos.
AddTicks(int64_t) constDevuelve una nueva instancia de la clase DateTime que representa el valor de fecha y hora que es la suma del valor representado por el objeto actual y el número especificado de intervalos de 100 nanosegundos.
AddYears(int) constDevuelve una nueva instancia de la clase DateTime que representa el valor de fecha y hora igual al representado por el objeto actual con el componente de año incrementado en el número especificado.
static Compare(DateTime, DateTime)Compara dos valores representados por las instancias especificadas de la clase DateTime y devuelve el valor que indica la posición relativa de los valores en la línea temporal.
CompareTo(DateTime) constCompara dos valores de fecha y hora representados por el objeto actual y la instancia especificada de la clase DateTime y devuelve el valor que indica la posición relativa de los valores en la línea temporal.
DateTime()Construye una instancia que representa el valor de fecha y hora más pequeño posible, igual a MinValue.
DateTime(int, int, int)Construye una instancia que representa un valor de fecha y hora especificado como un año, mes y día particulares.
DateTime(int, int, int, const SharedPtr<Globalization::Calendar>&)Construye una instancia que representa un valor de fecha y hora especificado como un año, mes y día particulares en el calendario especificado.
DateTime(int, int, int, int, int, int)Construye una instancia que representa un valor de fecha y hora especificado como un año, mes, día, hora, minuto y segundo determinados.
DateTime(int, int, int, int, int, int, DateTimeKind)Construye una instancia que representa un valor de fecha y hora especificado como un año, mes, día, hora, minuto y segundo determinados.
DateTime(int, int, int, int, int, int, const SharedPtr<Globalization::Calendar>&)Construye una instancia que representa un valor de fecha y hora especificado como un año, mes, día, hora, minuto y segundo determinados en el calendario especificado.
DateTime(int, int, int, int, int, int, int, DateTimeKind)Construye una instancia que representa un valor de fecha y hora especificado como un año, mes, día, hora, minuto, segundo y milisegundo determinados.
DateTime(int, int, int, int, int, int, int, const SharedPtr<Globalization::Calendar>&, DateTimeKind)Construye una instancia que representa un valor de fecha y hora especificado como un año, mes, día, hora, minuto, segundo y milisegundo determinados en el calendario especificado.
DateTime(int64_t, DateTimeKind)Construye una instancia que representa un valor de fecha y hora especificado como un número de ticks.
DateTime(int64_t, DateTimeKind, bool)Construye una instancia que representa un valor de fecha y hora especificado como un número de ticks. PARA USO INTERNO.
DateTime(const DateTime&)Construye una copia de una instancia.
static DaysInMonth(int, int)Devuelve el número de días del mes especificado del año especificado.
static Equals(DateTime, DateTime)Determina si las instancias especificadas de la clase DateTime representan el mismo valor de fecha y hora.
Equals(DateTime) constDetermina si la instancia especificada de la clase DateTime representa el mismo valor de fecha y hora que el objeto actual.
static FromBinary(int64_t)Deserializa el valor de fecha y hora desde el entero sin signo de 64 bits especificado y establece la nueva instancia de la clase DateTime con ese valor.
static FromFileTime(int64_t)Convierte el tiempo de archivo especificado a una instancia de la clase DateTime que representa el mismo valor de fecha y hora que la hora local.
static FromFileTimeUtc(int64_t)Convierte el tiempo de archivo especificado en una instancia de la clase DateTime que representa el mismo valor de fecha y hora que la hora UTC.
static FromOADate(double)Devuelve una instancia de la clase DateTime que representa el valor de fecha y hora equivalente a la OLE Automation Date especificada.
static FromUnixTime(time_t)Convierte el valor de tiempo Unix especificado en una instancia de la clase DateTime. USO INTERNO.
get_Date() constDevuelve una nueva instancia de la clase DateTime que representa la parte de fecha de la fecha y hora representada por el objeto actual, con cada componente de la parte de tiempo establecido en 0.
get_Day() constDevuelve el número ordinal del día del mes representado por el objeto actual.
get_DayOfWeek() constDevuelve un valor que representa el día de la semana que está representado por el objeto actual.
get_DayOfYear() constDevuelve el número ordinal del día del año representado por el objeto actual.
get_Hour() constDevuelve el componente de hora del valor de fecha y hora representado por el objeto actual.
get_Kind() constDevuelve el valor que indica si la fecha y hora representada por el objeto actual es una fecha y hora local, UTC o ninguna de las dos.
get_Millisecond() constDevuelve el componente de milisegundos del valor de fecha y hora representado por el objeto actual.
get_Minute() constDevuelve el componente de minutos del valor de fecha y hora representado por el objeto actual.
get_Month() constDevuelve el número ordinal del mes del año representado por el objeto actual.
static get_Now()Devuelve una instancia de la clase DateTime que representa la hora actual como hora local.
get_Second() constDevuelve el componente de segundos del valor de fecha y hora representado por el objeto actual.
get_Ticks() constDevuelve un número de intervalos de 100 nanosegundos transcurridos desde las 0:00:00 UTC, 1 de enero de 0001, en el calendario gregoriano, hasta la fecha y hora representadas por el objeto actual.
get_TimeOfDay() constDevuelve el valor que representa el intervalo de tiempo desde el comienzo del día representado por el objeto actual hasta el valor de fecha y hora representado por el objeto actual.
static get_Today()Devuelve una instancia de la clase DateTime que representa la fecha actual con cada componente de la porción de tiempo del valor representado por el objeto establecido en 0.
static get_UtcNow()Devuelve una instancia de la clase DateTime que representa la hora actual en UTC.
get_Year() constDevuelve el año representado por el objeto actual.
GetDateComponents(int&, int&, int&) constObtiene las partes de la fecha. PARA USO INTERNO.
GetDateTimeFormats() constDevuelve una matriz de cadenas donde cada elemento es la representación en cadena del objeto actual formateada con uno de los especificadores de formato estándar de fecha y hora.
GetDateTimeFormats(char_t) constDevuelve una matriz de cadenas donde cada elemento es la representación en cadena del objeto actual formateada con el especificador de formato estándar de fecha y hora especificado.
GetDateTimeFormats(const SharedPtr<IFormatProvider>&) constDevuelve una matriz de cadenas donde cada elemento es la representación en cadena del objeto actual formateada con uno de los especificadores de formato estándar de fecha y hora y el proveedor de formato especificado.
GetDateTimeFormats(char_t, const SharedPtr<IFormatProvider>&) constDevuelve una matriz de cadenas donde cada elemento es la representación en cadena del objeto actual formateada con el especificador de formato estándar de fecha y hora especificado y el proveedor de formato.
GetHashCode() constDevuelve un código hash para el objeto actual.
IsDaylightSavingTime() constDetermina si el valor de fecha y hora representado por el objeto actual se encuentra dentro del rango de horario de verano para la zona horaria actual.
static IsLeapYear(int)Determina si el año especificado es un año bisiesto.
IsNull() const
operator!=(DateTime) constDetermina si el objeto actual y el objeto DateTime especificado representan valores de fecha y hora distintos.
operator!=(std::nullptr_t) const
operator+(TimeSpan) constDevuelve una nueva instancia de la clase DateTime que representa el valor de fecha y hora que es la suma del valor representado por el objeto actual y el intervalo de tiempo especificado.
operator+=(TimeSpan)Establece el objeto actual al valor de fecha y hora que es la suma del valor representado por el objeto actual y el intervalo de tiempo especificado.
operator-(TimeSpan) constDevuelve una nueva instancia de la clase DateTime que representa el valor de fecha y hora que es el resultado de restar el intervalo de tiempo especificado del valor representado por el objeto actual.
operator-(DateTime) constDevuelve una instancia de la clase TimeSpan que representa el intervalo de tiempo entre los valores de fecha y hora representados por el objeto actual y el objeto especificado.
operator-=(TimeSpan)Establece el objeto actual al valor de fecha y hora que es el resultado de restar el intervalo de tiempo especificado del valor de fecha y hora representado por el objeto actual.
operator<(DateTime) constDetermina si el objeto actual representa el valor de fecha y hora que es anterior al valor representado por el objeto DateTime especificado.
operator<(std::nullptr_t) const
operator<=(DateTime) constDetermina si el objeto actual representa el valor de fecha y hora que es anterior o igual al valor representado por el objeto DateTime especificado.
operator<=(std::nullptr_t) const
operator=(const DateTime&)Asigna el valor representado por la instancia DateTime especificada al objeto actual.
operator==(DateTime) constDetermina si el objeto actual y el objeto DateTime especificado representan el mismo valor de fecha y hora.
operator==(std::nullptr_t) const
operator>(DateTime) constDetermina si el objeto actual representa el valor de fecha y hora que es posterior al valor representado por el objeto DateTime especificado.
operator>(std::nullptr_t) const
operator>=(DateTime) constDetermina si el objeto actual representa el valor de fecha y hora que es posterior o igual al valor representado por el objeto DateTime especificado.
operator>=(std::nullptr_t) const
static Parse(const String&)Convierte la representación en cadena especificada de un valor de fecha y hora al objeto DateTime equivalente.
static Parse(const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles)Convierte la representación de cadena especificada de un valor de fecha y hora al objeto DateTime equivalente usando información de formato específica de la cultura.
static Parse(const String&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles)
static Parse(const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles)
static Parse(const String&, std::nullptr_t, Globalization::DateTimeStyles)
static ParseExact(const String&, const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles)Convierte la representación de cadena especificada de un valor de fecha y hora al objeto DateTime equivalente usando el formato especificado y la información de formato específica de la cultura. El formato de la representación de cadena debe coincidir exactamente con el formato especificado. Lanza una excepción si la conversión falla.
static ParseExact(const String&, const String&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles)
static ParseExact(const String&, const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles)
static ParseExact(const String&, const String&, std::nullptr_t, Globalization::DateTimeStyles)
static ParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles)Convierte la representación de cadena especificada de un valor de fecha y hora al objeto DateTime equivalente usando los formatos especificados, la información de formato específica de la cultura y el estilo. El formato de la representación de cadena debe coincidir exactamente con uno o más de los formatos especificados. Lanza una excepción si la conversión falla.
static ParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles)
static ParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles)
static ParseExact(const String&, const ArrayPtr<String>&, std::nullptr_t, Globalization::DateTimeStyles)
static SpecifyKind(DateTime, DateTimeKind)Construye un nuevo objeto DateTime que representa el mismo número de ticks que el objeto DateTime especificado y representa la hora local, la hora UTC o ninguna, según lo especificado por el argumento kind.
Subtract(TimeSpan) constDevuelve una nueva instancia de la clase DateTime que representa el valor de fecha y hora que es el resultado de restar el intervalo de tiempo especificado del valor representado por el objeto actual.
Subtract(DateTime) constDevuelve una instancia de la clase TimeSpan que representa el intervalo de tiempo entre los valores de fecha y hora representados por el objeto actual y los objetos especificados.
ToBinary() constSerializa el objeto actual.
ToFileTime() constDevuelve un valor que representa el valor de fecha y hora del objeto actual como tiempo de archivo.
ToFileTimeUtc() constConvierte el valor de fecha y hora representado por el objeto actual a tiempo de archivo UTC.
ToLocalTime() constDevuelve una nueva instancia de la clase DateTime que representa el valor de fecha y hora del objeto actual como hora local.
ToLongDateString() constDevuelve una cadena que contiene la representación de cadena de fecha larga del objeto actual.
ToLongTimeString() constDevuelve una cadena que contiene la representación de cadena de hora larga del objeto actual.
ToOADate() constDevuelve el valor de fecha y hora representado por el objeto actual como Fecha de Automatización OLE.
ToShortDateString() constDevuelve una cadena que contiene la representación de cadena de fecha corta del objeto actual.
ToShortTimeString() constDevuelve una cadena que contiene la representación de cadena de hora corta del objeto actual.
ToString() constDevuelve la representación en cadena del valor de fecha y hora representado por el objeto actual usando las convenciones de formato definidas por la cultura actual.
ToString(const String&) constDevuelve una representación en cadena del valor de fecha y hora representado por el objeto actual usando el formato especificado y las convenciones de formato definidas por la cultura actual.
ToString(const SharedPtr<IFormatProvider>&) constDevuelve una representación en cadena del valor de fecha y hora representado por el objeto actual usando la información de formato especificada.
ToString(const SharedPtr<Globalization::CultureInfo>&) const
ToString(const SharedPtr<Globalization::DateTimeFormatInfo>&) const
ToString(std::nullptr_t) const
ToString(const String&, const SharedPtr<IFormatProvider>&) constDevuelve una representación en cadena del valor de fecha y hora representado por el objeto actual usando la información de formato especificada.
ToString(const String&, const SharedPtr<Globalization::CultureInfo>&) const
ToString(const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&) const
ToString(const String&, std::nullptr_t) const
ToUniversalTime() constDevuelve una nueva instancia de la clase DateTime que representa el valor de fecha y hora del objeto actual como UTC.
ToUnixTime() constDevuelve un valor que representa el valor de fecha y hora del objeto actual como tiempo Unix. SOLO USO INTERNO.
static TryParse(const String&, DateTime&)Convierte la representación en cadena especificada de un valor de fecha y hora al objeto DateTime equivalente.
static TryParse(const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles, DateTime&)Convierte la representación de cadena especificada de un valor de fecha y hora al objeto DateTime equivalente usando la información de formato específica de la cultura y el estilo especificados.
static TryParse(const String&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles, DateTime&)
static TryParse(const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles, DateTime&)
static TryParse(const String&, std::nullptr_t, Globalization::DateTimeStyles, DateTime&)
static TryParseExact(const String&, const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles, DateTime&)Convierte la representación de cadena especificada de un valor de fecha y hora al objeto DateTime equivalente usando el formato especificado, la información de formato específica de la cultura y el estilo. El formato de la representación de cadena debe coincidir exactamente con el formato especificado.
static TryParseExact(const String&, const String&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles, DateTime&)
static TryParseExact(const String&, const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles, DateTime&)
static TryParseExact(const String&, const String&, std::nullptr_t, Globalization::DateTimeStyles, DateTime&)
static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles, DateTime&)Convierte la representación de cadena especificada de un valor de fecha y hora al objeto DateTime equivalente usando los formatos especificados, la información de formato específica de la cultura y el estilo. El formato de la representación de cadena debe coincidir exactamente con uno o más de los formatos especificados.
static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles, DateTime&)
static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles, DateTime&)
static TryParseExact(const String&, const ArrayPtr<String>&, std::nullptr_t, Globalization::DateTimeStyles, DateTime&)
static Type()Devuelve un objeto TypeInfo que contiene información sobre esta clase.

Campos

CampoDescripción
static constexpr MaxTicksEl número de intervalos de 100 nanosegundos en el intervalo de tiempo entre el valor DateTime mínimo posible y el máximo posible.
static MaxValueUna instancia de la clase DateTime que representa el valor máximo posible de fecha y hora.
static constexpr MinTicksEl número mínimo de ticks que una instancia de la clase DateTime puede representar.
static MinValueUna instancia de la clase DateTime que representa el valor de fecha y hora mínimo posible.
static constexpr TicksPerDayEl número de ticks en un día.
static constexpr TicksPerHourEl número de ticks en una hora.
static constexpr TicksPerMicrosecondEl número de ticks en un microsegundo.
static constexpr TicksPerMillisecondEl número de ticks en un milisegundo.
static constexpr TicksPerMinuteEl número de ticks en un minuto.
static constexpr TicksPerSecondEl número de ticks en un segundo.
static UnixEpochUna instancia de la clase DateTime que representa el inicio de la época Unix (1970.01.01 00:00:00).

Observaciones

#include "system/console.h"
#include "system/date_time.h"

int main()
{
  using namespace System;

  // Crea la instancia de la clase 'DateTime'.
  DateTime dateTime{1990, 10, 30};

  // Imprime la instancia en varios formatos.
  Console::WriteLine(dateTime.ToShortDateString());
  Console::WriteLine(dateTime.ToShortTimeString());
  Console::WriteLine(dateTime.ToString());

  return 0;
}
/*
This code example produces the following output:
30.10.1990
0:00
30.10.1990 0:00:00
*/

Ver también