Classe System::DateTime

DateTime class

Rappresenta un valore di data e ora specifico sul continuum temporale. 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 DateTime

Metodi

MetodoDescrizione
Add(TimeSpan) constRestituisce una nuova istanza della classe DateTime che rappresenta un valore di data e ora risultante dall’aggiunta dell’intervallo di tempo specificato al valore di data e ora rappresentato dall’oggetto corrente.
AddDays(double) constRestituisce una nuova istanza della classe DateTime che rappresenta il valore di data e ora ottenuto dalla somma del valore rappresentato dall’oggetto corrente e del numero specificato di giorni.
AddHours(double) constRestituisce una nuova istanza della classe DateTime che rappresenta il valore di data e ora ottenuto dalla somma del valore rappresentato dall’oggetto corrente e del numero specificato di ore.
AddMilliseconds(double) constRestituisce una nuova istanza della classe DateTime che rappresenta il valore di data e ora ottenuto dalla somma del valore rappresentato dall’oggetto corrente e del numero specificato di millisecondi.
AddMinutes(double) constRestituisce una nuova istanza della classe DateTime che rappresenta il valore di data e ora ottenuto dalla somma del valore rappresentato dall’oggetto corrente e del numero specificato di minuti.
AddMonths(int) constRestituisce una nuova istanza della classe DateTime che rappresenta il valore di data e ora ottenuto dalla somma del valore rappresentato dall’oggetto corrente e del numero specificato di mesi.
AddSeconds(double) constRestituisce una nuova istanza della classe DateTime che rappresenta il valore di data e ora ottenuto dalla somma del valore rappresentato dall’oggetto corrente e del numero specificato di secondi.
AddTicks(int64_t) constRestituisce una nuova istanza della classe DateTime che rappresenta il valore di data e ora ottenuto dalla somma del valore rappresentato dall’oggetto corrente e del numero specificato di intervalli di 100 nanosecondi.
AddYears(int) constRestituisce una nuova istanza della classe DateTime che rappresenta il valore di data e ora uguale a quello rappresentato dall’oggetto corrente con la componente dell’anno aumentata del numero specificato.
static Compare(DateTime, DateTime)Confronta due valori rappresentati dalle istanze specificate della classe DateTime e restituisce il valore che indica le posizioni relative dei valori sulla linea temporale.
CompareTo(DateTime) constConfronta due valori di data e ora rappresentati dall’oggetto corrente e dall’istanza specificata della classe DateTime e restituisce il valore che indica le posizioni relative dei valori sulla linea temporale.
DateTime()Costruisce un’istanza che rappresenta il valore di data e ora più piccolo possibile, uguale a MinValue.
DateTime(int, int, int)Crea un’istanza che rappresenta un valore di data e ora specificato come un anno, mese e giorno particolari.
DateTime(int, int, int, const SharedPtr<Globalization::Calendar>&)Crea un’istanza che rappresenta un valore di data e ora specificato come un anno, mese e giorno particolari nel calendario specificato.
DateTime(int, int, int, int, int, int)Crea un’istanza che rappresenta un valore di data e ora specificato come un anno, mese, giorno, ora, minuto e secondo particolari.
DateTime(int, int, int, int, int, int, DateTimeKind)Crea un’istanza che rappresenta un valore di data e ora specificato come un anno, mese, giorno, ora, minuto e secondo particolari.
DateTime(int, int, int, int, int, int, const SharedPtr<Globalization::Calendar>&)Crea un’istanza che rappresenta un valore di data e ora specificato come un anno, mese, giorno, ora, minuto e secondo particolari nel calendario specificato.
DateTime(int, int, int, int, int, int, int, DateTimeKind)Crea un’istanza che rappresenta un valore di data e ora specificato come un anno, mese, giorno, ora, minuto, secondo e millisecondo particolari.
DateTime(int, int, int, int, int, int, int, const SharedPtr<Globalization::Calendar>&, DateTimeKind)Crea un’istanza che rappresenta un valore di data e ora specificato come un anno, mese, giorno, ora, minuto, secondo e millisecondo particolari nel calendario specificato.
DateTime(int64_t, DateTimeKind)Crea un’istanza che rappresenta un valore di data e ora specificato come un numero di tick.
DateTime(int64_t, DateTimeKind, bool)Crea un’istanza che rappresenta un valore di data e ora specificato come un numero di tick. PER USO INTERNO.
DateTime(const DateTime&)Copia costruttore di un’istanza.
static DaysInMonth(int, int)Restituisce il numero di giorni nel mese specificato dell’anno specificato.
static Equals(DateTime, DateTime)Determina se le istanze specificate della classe DateTime rappresentano lo stesso valore di data e ora.
Equals(DateTime) constDetermina se l’istanza specificata della classe DateTime rappresenta lo stesso valore di data e ora dell’oggetto corrente.
static FromBinary(int64_t)Deserializza il valore di data e ora dal numero intero senza segno a 64 bit specificato e imposta la nuova istanza della classe DateTime a quel valore.
static FromFileTime(int64_t)Converte il tempo di file specificato in un’istanza della classe DateTime che rappresenta lo stesso valore di data e ora dell’ora locale.
static FromFileTimeUtc(int64_t)Converte il tempo di file specificato in un’istanza della classe DateTime che rappresenta lo stesso valore di data e ora dell’ora UTC.
static FromOADate(double)Restituisce un’istanza della classe DateTime che rappresenta il valore di data e ora equivalente alla data OLE Automation specificata.
static FromUnixTime(time_t)Converte il valore di tempo Unix specificato in un’istanza della classe DateTime. PER USO INTERNO.
get_Date() constRestituisce una nuova istanza della classe DateTime che rappresenta la parte data della data e ora rappresentata dall’oggetto corrente, con ogni componente della parte ora impostata a 0.
get_Day() constRestituisce il numero ordinale del giorno nel mese rappresentato dall’oggetto corrente.
get_DayOfWeek() constRestituisce un valore che rappresenta il giorno della settimana rappresentato dall’oggetto corrente.
get_DayOfYear() constRestituisce il numero ordinale del giorno nell’anno rappresentato dall’oggetto corrente.
get_Hour() constRestituisce la componente ora del valore di data e ora rappresentato dall’oggetto corrente.
get_Kind() constRestituisce il valore che indica se la data e ora rappresentata dall’oggetto corrente è una data e ora locale, UTC o nessuna delle due.
get_Millisecond() constRestituisce la componente millisecondo del valore di data e ora rappresentato dall’oggetto corrente.
get_Minute() constRestituisce la componente minuto del valore di data e ora rappresentato dall’oggetto corrente.
get_Month() constRestituisce il numero ordinale del mese nell’anno rappresentato dall’oggetto corrente.
static get_Now()Restituisce un’istanza della classe DateTime che rappresenta l’ora corrente come ora locale.
get_Second() constRestituisce la componente dei secondi del valore data e ora rappresentato dall’oggetto corrente.
get_Ticks() constRestituisce un numero di intervalli di 100 nanosecondi trascorsi dal 0:00:00 UTC, 1 gennaio 0001, nel calendario gregoriano fino alla data e ora rappresentate dall’oggetto corrente.
get_TimeOfDay() constRestituisce il valore che rappresenta l’intervallo di tempo dall’inizio della giornata rappresentata dall’oggetto corrente fino al valore data e ora rappresentato dall’oggetto corrente.
static get_Today()Restituisce un’istanza della classe DateTime che rappresenta la data corrente con ogni componente della parte temporale del valore rappresentato dall’oggetto impostata a 0.
static get_UtcNow()Restituisce un’istanza della classe DateTime che rappresenta l’ora corrente come UTC.
get_Year() constRestituisce l’anno rappresentato dall’oggetto corrente.
GetDateComponents(int&, int&, int&) constOttiene le parti della data. PER USO INTERNO.
GetDateTimeFormats() constRestituisce un array di stringhe in cui ogni elemento è la rappresentazione testuale dell’oggetto corrente formattata con uno dei specificatori di formato data e ora standard.
GetDateTimeFormats(char_t) constRestituisce un array di stringhe in cui ogni elemento è la rappresentazione testuale dell’oggetto corrente formattata con lo specificatore di formato data e ora standard specificato.
GetDateTimeFormats(const SharedPtr<IFormatProvider>&) constRestituisce un array di stringhe in cui ogni elemento è la rappresentazione testuale dell’oggetto corrente formattata con uno dei specificatori di formato data e ora standard e con il provider di formato specificato.
GetDateTimeFormats(char_t, const SharedPtr<IFormatProvider>&) constRestituisce un array di stringhe in cui ogni elemento è la rappresentazione testuale dell’oggetto corrente formattata con lo specificatore di formato data e ora standard specificato e con il provider di formato.
GetHashCode() constRestituisce un codice hash per l’oggetto corrente.
IsDaylightSavingTime() constDetermina se il valore data e ora rappresentato dall’oggetto corrente rientra nell’intervallo dell’ora legale per il fuso orario corrente.
static IsLeapYear(int)Determina se l’anno specificato è un anno bisestile.
IsNull() const
operator!=(DateTime) constDetermina se l’oggetto corrente e l’oggetto DateTime specificato rappresentano valori data e ora distinti.
operator!=(std::nullptr_t) const
operator+(TimeSpan) constRestituisce una nuova istanza della classe DateTime che rappresenta il valore data e ora che è la somma del valore rappresentato dall’oggetto corrente e dell’intervallo di tempo specificato.
operator+=(TimeSpan)Imposta l’oggetto corrente al valore data e ora che è la somma del valore rappresentato dall’oggetto corrente e dell’intervallo di tempo specificato.
operator-(TimeSpan) constRestituisce una nuova istanza della classe DateTime che rappresenta il valore data e ora risultato dalla sottrazione dell’intervallo di tempo specificato dal valore rappresentato dall’oggetto corrente.
operator-(DateTime) constRestituisce un’istanza della classe TimeSpan che rappresenta l’intervallo di tempo tra i valori di data e ora rappresentati dall’oggetto corrente e da quello specificato.
operator-=(TimeSpan)Imposta l’oggetto corrente al valore data e ora che è il risultato della sottrazione dell’intervallo di tempo specificato dal valore data e ora rappresentato dall’oggetto corrente.
operator<(DateTime) constDetermina se l’oggetto corrente rappresenta il valore data e ora che è precedente al valore rappresentato dall’oggetto DateTime specificato.
operator<(std::nullptr_t) const
operator<=(DateTime) constDetermina se l’oggetto corrente rappresenta il valore data e ora che è precedente o uguale al valore rappresentato dall’oggetto DateTime specificato.
operator<=(std::nullptr_t) const
operator=(const DateTime&)Assegna il valore rappresentato dall’istanza DateTime specificata all’oggetto corrente.
operator==(DateTime) constDetermina se l’oggetto corrente e l’oggetto DateTime specificato rappresentano lo stesso valore data e ora.
operator==(std::nullptr_t) const
operator>(DateTime) constDetermina se l’oggetto corrente rappresenta il valore data e ora che è successivo al valore rappresentato dall’oggetto DateTime specificato.
operator>(std::nullptr_t) const
operator>=(DateTime) constDetermina se l’oggetto corrente rappresenta il valore di data e ora che è successivo o uguale al valore rappresentato dall’oggetto DateTime specificato.
operator>=(std::nullptr_t) const
static Parse(const String&)Converte la rappresentazione stringa specificata di un valore di data e ora nell’oggetto DateTime equivalente.
static Parse(const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles)Converte la rappresentazione stringa specificata di un valore di data e ora nell’oggetto DateTime equivalente utilizzando informazioni di formato specifiche della 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)Converte la rappresentazione stringa specificata di un valore di data e ora nell’oggetto DateTime equivalente utilizzando il formato specificato e informazioni di formato specifiche della cultura. Il formato della rappresentazione stringa deve corrispondere esattamente al formato specificato. Genera un’eccezione se la conversione fallisce.
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)Converte la rappresentazione stringa specificata di un valore di data e ora nell’oggetto DateTime equivalente utilizzando i formati specificati, informazioni di formato specifiche della cultura e lo stile. Il formato della rappresentazione stringa deve corrispondere esattamente a uno o più dei formati specificati. Genera un’eccezione se la conversione fallisce.
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)Crea un nuovo oggetto DateTime che rappresenta lo stesso numero di tick dell’oggetto DateTime specificato e rappresenta l’ora locale, l’ora UTC o nessuna delle due, come specificato dall’argomento kind.
Subtract(TimeSpan) constRestituisce una nuova istanza della classe DateTime che rappresenta il valore data e ora risultato dalla sottrazione dell’intervallo di tempo specificato dal valore rappresentato dall’oggetto corrente.
Subtract(DateTime) constRestituisce un’istanza della classe TimeSpan che rappresenta l’intervallo di tempo tra i valori di data e ora rappresentati dall’oggetto corrente e da quello specificato.
ToBinary() constSerializza l’oggetto corrente.
ToFileTime() constRestituisce un valore che rappresenta il valore di data e ora rappresentato dall’oggetto corrente come File time.
ToFileTimeUtc() constConverte il valore di data e ora rappresentato dall’oggetto corrente in File time UTC.
ToLocalTime() constRestituisce una nuova istanza della classe DateTime che rappresenta il valore di data e ora rappresentato dall’oggetto corrente come ora locale.
ToLongDateString() constRestituisce una stringa che contiene la rappresentazione della data lunga dell’oggetto corrente.
ToLongTimeString() constRestituisce una stringa che contiene la rappresentazione dell’ora lunga dell’oggetto corrente.
ToOADate() constRestituisce il valore di data e ora rappresentato dall’oggetto corrente come OLE Automation Date.
ToShortDateString() constRestituisce una stringa che contiene la rappresentazione della data breve dell’oggetto corrente.
ToShortTimeString() constRestituisce una stringa che contiene la rappresentazione dell’ora breve dell’oggetto corrente.
ToString() constRestituisce la rappresentazione stringa del valore di data e ora rappresentato dall’oggetto corrente utilizzando le convenzioni di formattazione definite dalla cultura corrente.
ToString(const String&) constRestituisce una rappresentazione stringa del valore di data e ora rappresentato dall’oggetto corrente utilizzando il formato specificato e le convenzioni di formattazione definite dalla cultura corrente.
ToString(const SharedPtr<IFormatProvider>&) constRestituisce una rappresentazione stringa del valore di data e ora rappresentato dall’oggetto corrente utilizzando le informazioni di formato specificate.
ToString(const SharedPtr<Globalization::CultureInfo>&) const
ToString(const SharedPtr<Globalization::DateTimeFormatInfo>&) const
ToString(std::nullptr_t) const
ToString(const String&, const SharedPtr<IFormatProvider>&) constRestituisce una rappresentazione stringa del valore di data e ora rappresentato dall’oggetto corrente utilizzando le informazioni di formato specificate.
ToString(const String&, const SharedPtr<Globalization::CultureInfo>&) const
ToString(const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&) const
ToString(const String&, std::nullptr_t) const
ToUniversalTime() constRestituisce una nuova istanza della classe DateTime che rappresenta il valore di data e ora rappresentato dall’oggetto corrente come UTC.
ToUnixTime() constRestituisce un valore che rappresenta il valore di data e ora rappresentato dall’oggetto corrente come Unix time. PER USO INTERNO.
static TryParse(const String&, DateTime&)Converte la rappresentazione stringa specificata di un valore di data e ora nell’oggetto DateTime equivalente.
static TryParse(const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles, DateTime&)Converte la rappresentazione stringa specificata di un valore di data e ora nell’oggetto DateTime equivalente utilizzando le informazioni di formato specifiche della cultura e lo stile specificati.
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&)Converte la rappresentazione stringa specificata di un valore di data e ora nell’oggetto DateTime equivalente utilizzando il formato specificato, le informazioni di formato specifiche della cultura e lo stile. Il formato della rappresentazione stringa deve corrispondere esattamente al formato specificato.
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&)Converte la rappresentazione stringa specificata di un valore di data e ora nell’oggetto DateTime equivalente utilizzando i formati specificati, le informazioni di formato specifiche della cultura e lo stile. Il formato della rappresentazione stringa deve corrispondere esattamente a uno o più dei formati specificati.
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()Restituisce un oggetto TypeInfo che contiene informazioni su questa classe.

Campi

CampoDescrizione
static constexpr MaxTicksIl numero di 100 nanosecondi nell’intervallo di tempo tra il valore minimo possibile e quello massimo possibile di DateTime.
static MaxValueUn’istanza della classe DateTime che rappresenta il valore di data e ora massimo possibile.
static constexpr MinTicksIl numero minimo di tick che un’istanza della classe DateTime può rappresentare.
static MinValueUn’istanza della classe DateTime che rappresenta il valore di data e ora minimo possibile.
static constexpr TicksPerDayIl numero di tick in un giorno.
static constexpr TicksPerHourIl numero di tick in un’ora.
static constexpr TicksPerMicrosecondIl numero di tick in un microsecondo.
static constexpr TicksPerMillisecondIl numero di tick in un millisecondo.
static constexpr TicksPerMinuteIl numero di tick in un minuto.
static constexpr TicksPerSecondIl numero di tick in un secondo.
static UnixEpochUn’istanza della classe DateTime che rappresenta l’inizio dell’epoca Unix (1970.01.01 00:00:00).

Osservazioni

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

int main()
{
  using namespace System;

  // Crea l'istanza della classe 'DateTime'.
  DateTime dateTime{1990, 10, 30};

  // Stampa l'istanza in diversi formati.
  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
*/

Vedi anche