Clase System::TimeSpan

TimeSpan class

Representa un intervalo de tiempo. 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 TimeSpan

Métodos

MétodoDescripción
Add(TimeSpan) constDevuelve una nueva instancia de la clase TimeSpan que representa un intervalo de tiempo que es la suma de los intervalos de tiempo representados por el objeto actual y el objeto especificado.
static Compare(TimeSpan, TimeSpan)Compara dos objetos TimeSpan.
CompareTo(TimeSpan) constCompara el objeto actual y el objeto especificado.
CompareTo(const SharedPtr<Object>&) constCompara el objeto actual y el objeto especificado.
Duration() constDevuelve una nueva instancia del objeto TimeSpan cuyo valor es el valor absoluto del objeto actual.
Equals(TimeSpan) constDetermina si el intervalo de tiempo representado por el objeto actual es igual al intervalo de tiempo representado por el objeto especificado.
Equals(const SharedPtr<Object>&) constDetermina si el intervalo de tiempo representado por el objeto actual es igual al intervalo de tiempo representado por el objeto especificado.
static Equals(TimeSpan, TimeSpan)Devuelve true si los objetos especificados representan el mismo intervalo de tiempo, de lo contrario - false.
static FromDays(double)Devuelve un nuevo objeto TimeSpan que representa el intervalo especificado.
static FromHours(double)Devuelve un nuevo objeto TimeSpan que representa el intervalo especificado.
static FromMilliseconds(double)Devuelve un nuevo objeto TimeSpan que representa el intervalo especificado.
static FromMinutes(double)Devuelve un nuevo objeto TimeSpan que representa el intervalo especificado.
static FromSeconds(double)Devuelve un nuevo objeto TimeSpan que representa el intervalo especificado.
static FromTicks(int64_t)Devuelve un nuevo objeto TimeSpan que representa el intervalo especificado.
get_Days() constDevuelve el componente de días del intervalo de tiempo representado por el objeto TimeSpan actual.
get_Hours() constDevuelve el componente de horas del intervalo de tiempo representado por el objeto TimeSpan actual.
get_Milliseconds() constDevuelve el componente de milisegundos del intervalo de tiempo representado por el objeto TimeSpan actual.
get_Minutes() constDevuelve el componente de minutos del intervalo de tiempo representado por el objeto TimeSpan actual.
get_Seconds() constDevuelve el componente de segundos del intervalo de tiempo representado por el objeto TimeSpan actual.
get_Ticks() constDevuelve el número de intervalos de 100 nanosegundos que constituyen el intervalo de tiempo representado por el objeto TimeSpan actual.
get_TotalDays() constDevuelve el valor del objeto TimeSpan actual expresado en días completos y fraccionarios.
get_TotalHours() constDevuelve el valor del objeto TimeSpan actual expresado en horas completas y fraccionarias.
get_TotalMilliseconds() constDevuelve el valor del objeto TimeSpan actual expresado en milisegundos completos y fraccionarios.
get_TotalMinutes() constDevuelve el valor del objeto TimeSpan actual expresado en minutos completos y fraccionarios.
get_TotalSeconds() constDevuelve el valor del objeto TimeSpan actual expresado en segundos completos y fraccionarios.
GetHashCode() constDevuelve un código hash para el objeto actual.
IsNull() const
Negate() constDevuelve una nueva instancia del objeto TimeSpan que representa el valor negado del objeto TimeSpan actual.
operator!=(TimeSpan) constDetermina si el intervalo de tiempo representado por el objeto actual no es igual al intervalo de tiempo representado por el objeto especificado.
operator!=(std::nullptr_t) const
operator+(TimeSpan) constDevuelve una nueva instancia de la clase TimeSpan que representa un intervalo de tiempo que es la suma de los intervalos de tiempo representados por el objeto actual y el objeto especificado.
operator+() constDevuelve sí mismo.
operator+=(TimeSpan)Asigna al objeto actual el intervalo de tiempo que es la suma del intervalo de tiempo representado por el objeto actual y el objeto especificado.
operator-(TimeSpan) constDevuelve una nueva instancia de la clase TimeSpan que representa un intervalo de tiempo que es el resultado de la resta del intervalo de tiempo representado por el objeto especificado del intervalo de tiempo representado por el objeto actual.
operator-() constDevuelve una nueva instancia del objeto TimeSpan que representa el valor negado del objeto TimeSpan actual.
operator-=(TimeSpan)Asigna al objeto actual el intervalo de tiempo que es el resultado de la resta del intervalo de tiempo representado por el objeto especificado del intervalo de tiempo representado por el objeto actual.
operator/(double) const
operator/(TimeSpan) const
operator/=(double)
operator<(TimeSpan) constDetermina si el intervalo de tiempo representado por el objeto actual es más corto que el intervalo de tiempo representado por el objeto especificado.
operator<(std::nullptr_t) const
operator<=(TimeSpan) constDetermina si el intervalo de tiempo representado por el objeto actual es más corto o igual al intervalo de tiempo representado por el objeto especificado.
operator<=(std::nullptr_t) const
operator=(const TimeSpan&)Establece el intervalo de tiempo representado por el objeto TimeSpan especificado al objeto TimeSpan actual.
operator==(TimeSpan) constDetermina si el intervalo de tiempo representado por el objeto actual es igual al intervalo de tiempo representado por el objeto especificado.
operator==(std::nullptr_t) const
operator>(TimeSpan) constDetermina si el intervalo de tiempo representado por el objeto actual es más largo que el intervalo de tiempo representado por el objeto especificado.
operator>(std::nullptr_t) const
operator>=(TimeSpan) constDetermina si el intervalo de tiempo representado por el objeto actual es mayor o igual al intervalo de tiempo representado por el objeto especificado.
operator>=(std::nullptr_t) const
static Parse(const String&)Convierte una cadena al objeto TimeSpan equivalente.
static Parse(const String&, const SharedPtr<IFormatProvider>&)Convierte una cadena al objeto TimeSpan equivalente usando el proveedor de formato especificado.
static Parse(const String&, const SharedPtr<Globalization::CultureInfo>&)
static Parse(const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&)
static Parse(const String&, std::nullptr_t)
static ParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<IFormatProvider>&, Globalization::TimeSpanStyles)Convierte una cadena al objeto TimeSpan equivalente usando los formatos especificados, el proveedor de formato y los estilos.
static ParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::CultureInfo>&, Globalization::TimeSpanStyles)
static ParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::TimeSpanStyles)
static ParseExact(const String&, const ArrayPtr<String>&, std::nullptr_t, Globalization::TimeSpanStyles)
static ParseExact(const String&, const String&, const SharedPtr<IFormatProvider>&, Globalization::TimeSpanStyles)Convierte una cadena al objeto TimeSpan equivalente usando el formato especificado, el proveedor de formato y los estilos.
static ParseExact(const String&, const String&, const SharedPtr<Globalization::CultureInfo>&, Globalization::TimeSpanStyles)
static ParseExact(const String&, const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::TimeSpanStyles)
static ParseExact(const String&, const String&, std::nullptr_t, Globalization::TimeSpanStyles)
Subtract(TimeSpan) constDevuelve una nueva instancia de la clase TimeSpan que representa un intervalo de tiempo que es el resultado de la resta del intervalo de tiempo representado por el objeto especificado del intervalo de tiempo representado por el objeto actual.
TimeSpan()Construye un objeto TimeSpan que representa un intervalo de tiempo cero.
explicit TimeSpan(int64_t)Construye una instancia de la clase TimeSpan que representa el intervalo de tiempo especificado.
TimeSpan(int, int, int)Construye una instancia de la clase TimeSpan que representa el intervalo de tiempo que es igual a la suma del número especificado de horas, minutos y segundos.
TimeSpan(int, int, int, int, int)Construye una instancia de la clase TimeSpan que representa el intervalo de tiempo que es igual a la suma del número especificado de horas, minutos, segundos y milisegundos.
TimeSpan(const TimeSpan&)Construye un objeto TimeSpan que representa el intervalo de tiempo igual al intervalo de tiempo representado por el objeto TimeSpan especificado.
ToString() constDevuelve la representación en cadena del intervalo de tiempo representado por el objeto actual.
ToString(const String&) constConvierte el valor del objeto actual a una representación en cadena equivalente, usando el formato especificado.
ToString(const String&, const SharedPtr<IFormatProvider>&) constConvierte el valor del objeto actual a una representación en cadena equivalente, usando el formato y el proveedor de formato especificados.
ToString(const String&, const SharedPtr<Globalization::CultureInfo>&) const
ToString(const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&) const
ToString(const String&, std::nullptr_t) const
static TryParse(const String&, TimeSpan&)Convierte una cadena al objeto TimeSpan equivalente y devuelve el resultado de la conversión.
static TryParse(const String&, const SharedPtr<IFormatProvider>&, TimeSpan&)Convierte una cadena al objeto TimeSpan equivalente usando el proveedor de formato especificado y devuelve el resultado de la conversión.
static TryParse(const String&, const SharedPtr<Globalization::CultureInfo>&, TimeSpan&)
static TryParse(const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, TimeSpan&)
static TryParse(const String&, std::nullptr_t, TimeSpan&)
static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<IFormatProvider>&, TimeSpan&)Convierte una cadena al objeto TimeSpan equivalente usando los formatos y el proveedor de formato especificados, y devuelve el resultado de la conversión.
static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::CultureInfo>&, TimeSpan&)
static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::DateTimeFormatInfo>&, TimeSpan&)
static TryParseExact(const String&, const ArrayPtr<String>&, std::nullptr_t, TimeSpan&)
static TryParseExact(const String&, const String&, const SharedPtr<IFormatProvider>&, Globalization::TimeSpanStyles, TimeSpan&)Convierte una cadena al objeto TimeSpan equivalente usando el formato, el proveedor de formato y los estilos especificados, y devuelve el resultado de la conversión.
static TryParseExact(const String&, const String&, const SharedPtr<Globalization::CultureInfo>&, Globalization::TimeSpanStyles, TimeSpan&)
static TryParseExact(const String&, const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::TimeSpanStyles, TimeSpan&)
static TryParseExact(const String&, const String&, std::nullptr_t, Globalization::TimeSpanStyles, TimeSpan&)
static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<IFormatProvider>&, Globalization::TimeSpanStyles, TimeSpan&)Convierte una cadena al objeto TimeSpan equivalente usando los formatos, el proveedor de formato y los estilos especificados, y devuelve el resultado de la conversión.
static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::CultureInfo>&, Globalization::TimeSpanStyles, TimeSpan&)
static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::TimeSpanStyles, TimeSpan&)
static TryParseExact(const String&, const ArrayPtr<String>&, std::nullptr_t, Globalization::TimeSpanStyles, TimeSpan&)
static TryParseExact(const String&, const String&, const SharedPtr<IFormatProvider>&, TimeSpan&)Convierte una cadena al objeto TimeSpan equivalente usando el formato y el proveedor de formato especificados, y devuelve el resultado de la conversión.
static TryParseExact(const String&, const String&, const SharedPtr<Globalization::CultureInfo>&, TimeSpan&)
static TryParseExact(const String&, const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, TimeSpan&)
static TryParseExact(const String&, const String&, std::nullptr_t, TimeSpan&)
static Type()Devuelve un objeto TypeInfo que representa la estructura TimeSpan.

Campos

CampoDescripción
static MaxValueEl objeto TimeSpan que representa el intervalo más largo posible.
static MinValue/// El objeto TimeSpan que representa el intervalo más corto posible.
static constexpr TicksPerDayEl número de intervalos de 100 nanosegundos en un día (intervalo de 24 horas).
static constexpr TicksPerHourEl número de intervalos de 100 nanosegundos en una hora.
static constexpr TicksPerMillisecondEl número de intervalos de 100 nanosegundos en un milisegundo.
static constexpr TicksPerMinuteEl número de intervalos de 100 nanosegundos en un minuto.
static constexpr TicksPerSecondEl número de intervalos de 100 nanosegundos en un segundo.
static ZeroEl objeto TimeSpan que representa el intervalo cero.

Observaciones

#include "system/datetime.h"
#include "system/timespan.h"
#include <iostream>

int main()
{
  const auto date1 = System::DateTime(2021, 01, 01);
  const auto date2 = System::DateTime(2021, 10, 30);

  const auto interval = date2 - date1;

  std::cout << "Number of ticks: " << interval.get_Ticks() << std::endl;
  std::cout << "Number of milliseconds: " << interval.get_Milliseconds() << std::endl;
  std::cout << "Total number of milliseconds: " << interval.get_TotalMilliseconds() << std::endl;
  std::cout << "Number of minutes: " << interval.get_Minutes() << std::endl;
  std::cout << "Total number of minutes: " << interval.get_TotalMinutes() << std::endl;
  std::cout << "Number of hours: " << interval.get_Hours() << std::endl;
  std::cout << "Total number of hours: " << interval.get_Hours() << std::endl;
  std::cout << "Number of days: " << interval.get_Days() << std::endl;
  std::cout << "Total number of days: " << interval.get_TotalDays() << std::endl;

  return 0;
}
/*
This code example produces the following output:
Number of ticks: 260928000000000
Number of milliseconds: 0
Total number of milliseconds: 2.60928e+10
Number of minutes: 0
Total number of minutes: 434880
Number of hours: 0
Total number of hours: 0
Number of days: 302
Total number of days: 302
*/

Ver también