Clase System::DateTime
Contenido
[
Ocultar
]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étodo | Descripción |
|---|---|
| Add(TimeSpan) const | Devuelve 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) const | Devuelve 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) const | Devuelve 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) const | Devuelve 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) const | Devuelve 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) const | Devuelve 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) const | Devuelve 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) const | Devuelve 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) const | Devuelve 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) const | Compara 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) const | Determina 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() const | Devuelve 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() const | Devuelve el número ordinal del día del mes representado por el objeto actual. |
| get_DayOfWeek() const | Devuelve un valor que representa el día de la semana que está representado por el objeto actual. |
| get_DayOfYear() const | Devuelve el número ordinal del día del año representado por el objeto actual. |
| get_Hour() const | Devuelve el componente de hora del valor de fecha y hora representado por el objeto actual. |
| get_Kind() const | Devuelve 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() const | Devuelve el componente de milisegundos del valor de fecha y hora representado por el objeto actual. |
| get_Minute() const | Devuelve el componente de minutos del valor de fecha y hora representado por el objeto actual. |
| get_Month() const | Devuelve 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() const | Devuelve el componente de segundos del valor de fecha y hora representado por el objeto actual. |
| get_Ticks() const | Devuelve 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() const | Devuelve 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() const | Devuelve el año representado por el objeto actual. |
| GetDateComponents(int&, int&, int&) const | Obtiene las partes de la fecha. PARA USO INTERNO. |
| GetDateTimeFormats() const | Devuelve 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) const | Devuelve 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>&) const | Devuelve 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>&) const | Devuelve 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() const | Devuelve un código hash para el objeto actual. |
| IsDaylightSavingTime() const | Determina 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) const | Determina si el objeto actual y el objeto DateTime especificado representan valores de fecha y hora distintos. |
| operator!=(std::nullptr_t) const | |
| operator+(TimeSpan) const | Devuelve 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) const | Devuelve 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) const | Devuelve 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) const | Determina 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) const | Determina 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) const | Determina si el objeto actual y el objeto DateTime especificado representan el mismo valor de fecha y hora. |
| operator==(std::nullptr_t) const | |
| operator>(DateTime) const | Determina 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) const | Determina 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) const | Devuelve 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) const | Devuelve 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() const | Serializa el objeto actual. |
| ToFileTime() const | Devuelve un valor que representa el valor de fecha y hora del objeto actual como tiempo de archivo. |
| ToFileTimeUtc() const | Convierte el valor de fecha y hora representado por el objeto actual a tiempo de archivo UTC. |
| ToLocalTime() const | Devuelve una nueva instancia de la clase DateTime que representa el valor de fecha y hora del objeto actual como hora local. |
| ToLongDateString() const | Devuelve una cadena que contiene la representación de cadena de fecha larga del objeto actual. |
| ToLongTimeString() const | Devuelve una cadena que contiene la representación de cadena de hora larga del objeto actual. |
| ToOADate() const | Devuelve el valor de fecha y hora representado por el objeto actual como Fecha de Automatización OLE. |
| ToShortDateString() const | Devuelve una cadena que contiene la representación de cadena de fecha corta del objeto actual. |
| ToShortTimeString() const | Devuelve una cadena que contiene la representación de cadena de hora corta del objeto actual. |
| ToString() const | Devuelve 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&) const | Devuelve 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>&) const | Devuelve 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>&) const | Devuelve 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() const | Devuelve una nueva instancia de la clase DateTime que representa el valor de fecha y hora del objeto actual como UTC. |
| ToUnixTime() const | Devuelve 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
| Campo | Descripción |
|---|---|
| static constexpr MaxTicks | El 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 MaxValue | Una instancia de la clase DateTime que representa el valor máximo posible de fecha y hora. |
| static constexpr MinTicks | El número mínimo de ticks que una instancia de la clase DateTime puede representar. |
| static MinValue | Una instancia de la clase DateTime que representa el valor de fecha y hora mínimo posible. |
| static constexpr TicksPerDay | El número de ticks en un día. |
| static constexpr TicksPerHour | El número de ticks en una hora. |
| static constexpr TicksPerMicrosecond | El número de ticks en un microsegundo. |
| static constexpr TicksPerMillisecond | El número de ticks en un milisegundo. |
| static constexpr TicksPerMinute | El número de ticks en un minuto. |
| static constexpr TicksPerSecond | El número de ticks en un segundo. |
| static UnixEpoch | Una 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
- Namespace System
- Library Aspose.Page for C++