System::TimeSpan class

TimeSpan class

Rappresenta un intervallo di tempo. Questo tipo dovrebbe essere allocato sullo stack e passato alle funzioni per valore o per riferimento. Non utilizzare mai la classe System::SmartPtr per gestire oggetti di questo tipo.

class TimeSpan

Metodi

MetodoDescrizione
Add(TimeSpan) constRestituisce una nuova istanza della classe TimeSpan che rappresenta un intervallo di tempo pari alla somma degli intervalli di tempo rappresentati dall’oggetto corrente e da quello specificato.
static Compare(TimeSpan, TimeSpan)Confronta due oggetti TimeSpan.
CompareTo(TimeSpan) constConfronta l’oggetto corrente e quello specificato.
CompareTo(const SharedPtr<Object>&) constConfronta l’oggetto corrente e quello specificato.
Duration() constRestituisce una nuova istanza dell’oggetto TimeSpan il cui valore è il valore assoluto dell’oggetto corrente.
Equals(TimeSpan) constDetermina se l’intervallo di tempo rappresentato dall’oggetto corrente è uguale all’intervallo di tempo rappresentato dall’oggetto specificato.
Equals(const SharedPtr<Object>&) constDetermina se l’intervallo di tempo rappresentato dall’oggetto corrente è uguale all’intervallo di tempo rappresentato dall’oggetto specificato.
static Equals(TimeSpan, TimeSpan)Restituisce true se gli oggetti specificati rappresentano lo stesso intervallo di tempo, altrimenti false.
static FromDays(double)Restituisce un nuovo oggetto TimeSpan che rappresenta l’intervallo specificato.
static FromHours(double)Restituisce un nuovo oggetto TimeSpan che rappresenta l’intervallo specificato.
static FromMilliseconds(double)Restituisce un nuovo oggetto TimeSpan che rappresenta l’intervallo specificato.
static FromMinutes(double)Restituisce un nuovo oggetto TimeSpan che rappresenta l’intervallo specificato.
static FromSeconds(double)Restituisce un nuovo oggetto TimeSpan che rappresenta l’intervallo specificato.
static FromTicks(int64_t)Restituisce un nuovo oggetto TimeSpan che rappresenta l’intervallo specificato.
get_Days() constRestituisce la componente giorni dell’intervallo di tempo rappresentato dall’oggetto TimeSpan corrente.
get_Hours() constRestituisce la componente ore dell’intervallo di tempo rappresentato dall’oggetto TimeSpan corrente.
get_Milliseconds() constRestituisce la componente millisecondi dell’intervallo di tempo rappresentato dall’oggetto TimeSpan corrente.
get_Minutes() constRestituisce la componente minuti dell’intervallo di tempo rappresentato dall’oggetto TimeSpan corrente.
get_Seconds() constRestituisce la componente secondi dell’intervallo di tempo rappresentato dall’oggetto TimeSpan corrente.
get_Ticks() constRestituisce il numero di intervalli di 100 nanosecondi che costituiscono l’intervallo di tempo rappresentato dall’oggetto TimeSpan corrente.
get_TotalDays() constRestituisce il valore dell’oggetto TimeSpan corrente espresso in giorni interi e frazionari.
get_TotalHours() constRestituisce il valore dell’oggetto TimeSpan corrente espresso in ore intere e frazionarie.
get_TotalMilliseconds() constRestituisce il valore dell’oggetto TimeSpan corrente espresso in millisecondi interi e frazionari.
get_TotalMinutes() constRestituisce il valore dell’oggetto TimeSpan corrente espresso in minuti interi e frazionari.
get_TotalSeconds() constRestituisce il valore dell’oggetto TimeSpan corrente espresso in secondi interi e frazionari.
GetHashCode() constRestituisce un codice hash per l’oggetto corrente.
IsNull() const
Negate() constRestituisce una nuova istanza dell’oggetto TimeSpan che rappresenta il valore negato rappresentato dall’oggetto TimeSpan corrente.
operator!=(TimeSpan) constDetermina se l’intervallo di tempo rappresentato dall’oggetto corrente non è uguale all’intervallo di tempo rappresentato dall’oggetto specificato.
operator!=(std::nullptr_t) const
operator+(TimeSpan) constRestituisce una nuova istanza della classe TimeSpan che rappresenta un intervallo di tempo pari alla somma degli intervalli di tempo rappresentati dall’oggetto corrente e da quello specificato.
operator+() constRestituisce se stesso.
operator+=(TimeSpan)Assegna all’oggetto corrente l’intervallo di tempo che è la somma dell’intervallo di tempo rappresentato dall’oggetto corrente e da quello specificato.
operator-(TimeSpan) constRestituisce una nuova istanza della classe TimeSpan che rappresenta un intervallo di tempo risultato della sottrazione dell’intervallo di tempo rappresentato dall’oggetto specificato da quello rappresentato dall’oggetto corrente.
operator-() constRestituisce una nuova istanza dell’oggetto TimeSpan che rappresenta il valore negato rappresentato dall’oggetto TimeSpan corrente.
operator-=(TimeSpan)Assegna all’oggetto corrente l’intervallo di tempo risultato della sottrazione dell’intervallo di tempo rappresentato dall’oggetto specificato da quello rappresentato dall’oggetto corrente.
operator/(double) const
operator/(TimeSpan) const
operator/=(double)
operator<(TimeSpan) constDetermina se l’intervallo di tempo rappresentato dall’oggetto corrente è più breve dell’intervallo di tempo rappresentato dall’oggetto specificato.
operator<(std::nullptr_t) const
operator<=(TimeSpan) constDetermina se l’intervallo di tempo rappresentato dall’oggetto corrente è più breve o uguale all’intervallo di tempo rappresentato dall’oggetto specificato.
operator<=(std::nullptr_t) const
operator=(const TimeSpan&)Imposta l’intervallo di tempo rappresentato dall’oggetto TimeSpan specificato sull’oggetto TimeSpan corrente.
operator==(TimeSpan) constDetermina se l’intervallo di tempo rappresentato dall’oggetto corrente è uguale all’intervallo di tempo rappresentato dall’oggetto specificato.
operator==(std::nullptr_t) const
operator>(TimeSpan) constDetermina se l’intervallo di tempo rappresentato dall’oggetto corrente è più lungo dell’intervallo di tempo rappresentato dall’oggetto specificato.
operator>(std::nullptr_t) const
operator>=(TimeSpan) constDetermina se l’intervallo di tempo rappresentato dall’oggetto corrente è più lungo o uguale all’intervallo di tempo rappresentato dall’oggetto specificato.
operator>=(std::nullptr_t) const
static Parse(const String&)Converte la stringa in un oggetto TimeSpan equivalente.
static Parse(const String&, const SharedPtr<IFormatProvider>&)Converte la stringa in un oggetto TimeSpan equivalente utilizzando il provider di formato specificato.
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)Converte la stringa in un oggetto TimeSpan equivalente utilizzando i formati specificati, il provider di formato e gli stili.
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)Converte la stringa in un oggetto TimeSpan equivalente utilizzando il formato specificato, il provider di formato e gli stili.
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) constRestituisce una nuova istanza della classe TimeSpan che rappresenta un intervallo di tempo risultato della sottrazione dell’intervallo di tempo rappresentato dall’oggetto specificato da quello rappresentato dall’oggetto corrente.
TimeSpan()Crea un oggetto TimeSpan che rappresenta un intervallo di tempo zero.
explicit TimeSpan(int64_t)Crea un’istanza della classe TimeSpan che rappresenta l’intervallo di tempo specificato.
TimeSpan(int, int, int)Crea un’istanza della classe TimeSpan che rappresenta l’intervallo di tempo pari alla somma del numero specificato di ore, minuti e secondi.
TimeSpan(int, int, int, int, int)Crea un’istanza della classe TimeSpan che rappresenta l’intervallo di tempo pari alla somma del numero specificato di ore, minuti, secondi e millisecondi.
TimeSpan(const TimeSpan&)Crea un oggetto TimeSpan che rappresenta l’intervallo di tempo uguale all’intervallo di tempo rappresentato dall’oggetto TimeSpan specificato.
ToString() constRestituisce la rappresentazione stringa dell’intervallo di tempo rappresentato dall’oggetto corrente.
ToString(const String&) constConverte il valore dell’oggetto corrente in una rappresentazione stringa equivalente, utilizzando il formato specificato.
ToString(const String&, const SharedPtr<IFormatProvider>&) constConverte il valore dell’oggetto corrente in una rappresentazione stringa equivalente, utilizzando il formato e il provider di formato specificati.
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&)Converte la stringa in un oggetto TimeSpan equivalente e restituisce il risultato della conversione.
static TryParse(const String&, const SharedPtr<IFormatProvider>&, TimeSpan&)Converte la stringa in un oggetto TimeSpan equivalente utilizzando il provider di formato specificato e restituisce il risultato della conversione.
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&)Converte la stringa in un oggetto TimeSpan equivalente utilizzando i formati e il provider di formato specificati, e restituisce il risultato della conversione.
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&)Converte la stringa in un oggetto TimeSpan equivalente utilizzando il formato, il provider di formato e gli stili specificati, e restituisce il risultato della conversione.
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&)Converte la stringa in un oggetto TimeSpan equivalente utilizzando i formati, il provider di formato e gli stili specificati, e restituisce il risultato della conversione.
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&)Converte la stringa in un oggetto TimeSpan equivalente utilizzando il formato e il provider di formato specificati, e restituisce il risultato della conversione.
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()Restituisce un oggetto TypeInfo che rappresenta la struttura TimeSpan.

Campi

CampoDescrizione
static MaxValueL’oggetto TimeSpan che rappresenta l’intervallo più lungo possibile.
static MinValue/// L’oggetto TimeSpan che rappresenta l’intervallo più breve possibile.
static constexpr TicksPerDayIl numero di intervalli di 100 nanosecondi in un giorno (intervallo di 24 ore).
static constexpr TicksPerHourIl numero di intervalli di 100 nanosecondi in un’ora.
static constexpr TicksPerMillisecondIl numero di intervalli di 100 nanosecondi in un millisecondo.
static constexpr TicksPerMinuteIl numero di intervalli di 100 nanosecondi in un minuto.
static constexpr TicksPerSecondIl numero di intervalli di 100 nanosecondi in un secondo.
static ZeroL’oggetto TimeSpan che rappresenta l’intervallo zero.

Osservazioni

#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
*/

Vedi anche