DateTime Struct

Definizione

Spazio dei nomi:
System
Assembly:
mscorlib.dll, System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll

Rappresenta un istante in tempo, in genere espresso come data e ora del giorno.

public value class DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable
public value class DateTime : IComparable, IConvertible, IFormattable
public value class DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System::Runtime::Serialization::ISerializable
public value class DateTime : IComparable, IComparable<DateTime>, IEquatable<DateTime>, IFormattable
public struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable
[System.Serializable]
public struct DateTime : IComparable, IConvertible, IFormattable
[System.Serializable]
public struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System.Runtime.Serialization.ISerializable
public struct DateTime : IComparable, IComparable<DateTime>, IEquatable<DateTime>, IFormattable
public struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System.Runtime.Serialization.ISerializable
public readonly struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System.Runtime.Serialization.ISerializable
type DateTime = struct
    interface IConvertible
    interface IFormattable
[<System.Serializable>]
type DateTime = struct
    interface IFormattable
    interface IConvertible
[<System.Serializable>]
type DateTime = struct
    interface IFormattable
    interface IConvertible
    interface ISerializable
type DateTime = struct
    interface IFormattable
type DateTime = struct
    interface IConvertible
    interface IFormattable
    interface ISerializable
Public Structure DateTime
Implements IComparable, IComparable(Of DateTime), IConvertible, IEquatable(Of DateTime), IFormattable
Public Structure DateTime
Implements IComparable, IConvertible, IFormattable
Public Structure DateTime
Implements IComparable, IComparable(Of DateTime), IConvertible, IEquatable(Of DateTime), IFormattable, ISerializable
Public Structure DateTime
Implements IComparable, IComparable(Of DateTime), IEquatable(Of DateTime), IFormattable
Ereditarietà
Object
ValueType
DateTime
Attributi
SerializableAttribute
Implementazioni
IComparable IComparable<DateTime> IConvertible IEquatable<DateTime> IFormattable ISerializable

Commenti

Per altre informazioni su questa API, vedere Osservazioni supplementari sulle API per DateTime.

Costruttori

Nome Descrizione
DateTime(Int32, Int32, Int32, Calendar)

Inizializza una nuova istanza della DateTime struttura nell'anno, nel mese e nel giorno specificati per il calendario specificato.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Calendar)

Inizializza una nuova istanza della DateTime struttura nell'anno, nel mese, nel giorno, nell'ora, nel minuto e nel secondo per il calendario specificato.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)

Inizializza una nuova istanza della DateTime struttura per l'anno, il mese, il giorno, l'ora, il minuto, il secondo e l'ora UTC (Coordinated Universal Time) specificati o l'ora locale.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, DateTimeKind)

Inizializza una nuova istanza della DateTime struttura per l'anno, il mese, il giorno, l'ora, il minuto, il secondo, il millisecondo e l'ora UTC (Coordinated Universal Time) specificati per il calendario specificato.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar)

Inizializza una nuova istanza della DateTime struttura per l'anno, il mese, il giorno, l'ora, il minuto, il secondo e il millisecondo specificati per il calendario specificato.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)

Inizializza una nuova istanza della DateTime struttura sull'anno, il mese, il giorno, l'ora, il minuto, il secondo, il millisecondo e l'ora UTC (Coordinated Universal Time) specificati o l'ora locale.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)

Inizializza una nuova istanza della DateTime struttura nell'anno, nel mese, nel giorno, nell'ora, nel minuto, nel secondo e nel millisecondo specificati.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32)

Inizializza una nuova istanza della DateTime struttura nell'anno, nel mese, nel giorno, nell'ora, nel minuto e nel secondo specificati.
DateTime(Int32, Int32, Int32)

Inizializza una nuova istanza della DateTime struttura nell'anno, nel mese e nel giorno specificati.
DateTime(Int64, DateTimeKind)

Inizializza una nuova istanza della DateTime struttura in un numero specificato di tick e in ora UTC (Coordinated Universal Time) o ora locale.
DateTime(Int64)

Inizializza una nuova istanza della DateTime struttura in un numero specificato di tick.

Campi

Nome Descrizione
MaxValue

Rappresenta il valore massimo possibile di DateTime. Questo campo è di sola lettura.
MinValue

Rappresenta il valore minimo possibile di DateTime. Questo campo è di sola lettura.
UnixEpoch

Il valore di questa costante equivale a 00:00:00.00.000000 UTC, 1 gennaio 1970, nel calendario gregoriano. UnixEpoch definisce il punto nel tempo in cui l'ora Unix è uguale a 0.

Proprietà

Nome Descrizione
Date

Ottiene il componente data di questa istanza.
Day

Ottiene il giorno del mese rappresentato da questa istanza.
DayOfWeek

Ottiene il giorno della settimana rappresentato da questa istanza.
DayOfYear

Ottiene il giorno dell'anno rappresentato da questa istanza.
Hour

Ottiene il componente dell'ora della data rappresentata da questa istanza.
Kind

Ottiene un valore che indica se l'ora rappresentata da questa istanza è basata sull'ora locale, sull'ora UTC (Coordinated Universal Time) o su nessuno dei due.
Millisecond

Ottiene il componente millisecondi della data rappresentata da questa istanza.
Minute

Ottiene il componente minuto della data rappresentata da questa istanza.
Month

Ottiene il componente mese della data rappresentata da questa istanza.
Now

Ottiene un DateTime oggetto impostato sulla data e l'ora correnti del computer, espressa come ora locale.
Second

Ottiene la componente dei secondi della data rappresentata da questa istanza.
Ticks

Ottiene il numero di tick che rappresentano la data e l'ora di questa istanza.
TimeOfDay

Ottiene l'ora del giorno per questa istanza.
Today

Ottiene la data corrente.
UtcNow

Ottiene un DateTime oggetto impostato sulla data e l'ora correnti del computer, espressa come utc (Coordinated Universal Time).
Year

Ottiene il componente anno della data di cui questa istanza è rappresentata.

Metodi

Nome Descrizione
Add(TimeSpan)

Restituisce un nuovo DateTime oggetto che aggiunge il valore dell'oggetto specificato TimeSpan al valore di questa istanza.
AddDays(Double)

Restituisce un nuovo DateTime oggetto che aggiunge il numero di giorni specificato al valore di questa istanza.
AddHours(Double)

Restituisce un nuovo DateTime oggetto che aggiunge il numero di ore specificato al valore di questa istanza.
AddMilliseconds(Double)

Restituisce un nuovo DateTime oggetto che aggiunge il numero di millisecondi specificato al valore di questa istanza.
AddMinutes(Double)

Restituisce un nuovo DateTime oggetto che aggiunge il numero specificato di minuti al valore di questa istanza.
AddMonths(Int32)

Restituisce un nuovo DateTime oggetto che aggiunge il numero di mesi specificato al valore di questa istanza.
AddSeconds(Double)

Restituisce un nuovo DateTime oggetto che aggiunge il numero di secondi specificato al valore di questa istanza.
AddTicks(Int64)

Restituisce un nuovo DateTime oggetto che aggiunge il numero specificato di tick al valore di questa istanza.
AddYears(Int32)

Restituisce un nuovo DateTime oggetto che aggiunge il numero di anni specificato al valore di questa istanza.
Compare(DateTime, DateTime)

Confronta due istanze di DateTime e restituisce un numero intero che indica se la prima istanza è precedente, uguale o successiva alla seconda istanza.
CompareTo(DateTime)

Confronta il valore di questa istanza con un valore specificato DateTime e restituisce un intero che indica se questa istanza è precedente, uguale o successiva al valore specificato DateTime .
CompareTo(Object)

Confronta il valore di questa istanza con un oggetto specificato che contiene un valore specificato DateTime e restituisce un intero che indica se questa istanza è precedente, uguale o successiva al valore specificato DateTime .
DaysInMonth(Int32, Int32)

Restituisce il numero di giorni nel mese e nell'anno specificati.
Equals(DateTime, DateTime)

Restituisce un valore che indica se due DateTime istanze hanno lo stesso valore di data e ora.
Equals(DateTime)

Restituisce un valore che indica se il valore di questa istanza è uguale al valore dell'istanza specificata DateTime .
Equals(Object)

Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.
FromBinary(Int64)

Deserializza un valore binario a 64 bit e ricrea un oggetto serializzato DateTime originale.
FromFileTime(Int64)

Converte l'ora del file di Windows specificata in un'ora locale equivalente.
FromFileTimeUtc(Int64)

Converte l'ora del file di Windows specificata in un'ora UTC equivalente.
FromOADate(Double)

Restituisce un DateTime equivalente alla data di automazione OLE specificata.
GetDateTimeFormats()

Converte il valore di questa istanza in tutte le rappresentazioni di stringa supportate dagli identificatori di formato di data e ora standard.
GetDateTimeFormats(Char, IFormatProvider)

Converte il valore di questa istanza in tutte le rappresentazioni di stringa supportate dall'identificatore di formato di data e ora standard e dalle informazioni di formattazione specifiche delle impostazioni cultura specificate.
GetDateTimeFormats(Char)

Converte il valore di questa istanza in tutte le rappresentazioni di stringa supportate dall'identificatore di formato di data e ora standard specificato.
GetDateTimeFormats(IFormatProvider)

Converte il valore di questa istanza in tutte le rappresentazioni di stringa supportate dagli identificatori di formato di data e ora standard e dalle informazioni di formattazione specifiche delle impostazioni cultura specificate.
GetHashCode()

Restituisce il codice hash per questa istanza.
GetTypeCode()

Restituisce l'oggetto per il TypeCode tipo di DateTimevalore .
IsDaylightSavingTime()

Indica se questa istanza di DateTime è compresa nell'intervallo di ora legale per il fuso orario corrente.
IsLeapYear(Int32)

Restituisce un'indicazione se l'anno specificato è un anno bisestile.
Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)

Converte un intervallo di memoria che contiene la rappresentazione di stringa di una data e dell'ora nell'equivalente DateTime utilizzando informazioni sul formato specifiche delle impostazioni cultura e uno stile di formattazione.
Parse(String, IFormatProvider, DateTimeStyles)

Converte la rappresentazione di stringa di una data e dell'ora nell'equivalente DateTime utilizzando informazioni di formato specifiche delle impostazioni cultura e uno stile di formattazione.
Parse(String, IFormatProvider)

Converte la rappresentazione di stringa di una data e di un'ora nell'equivalente DateTime utilizzando informazioni sul formato specifiche delle impostazioni cultura.
Parse(String)

Converte la rappresentazione di stringa di una data e di un'ora nell'equivalente DateTime utilizzando le convenzioni delle impostazioni cultura correnti.
ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)

Converte la rappresentazione di intervallo specificata di una data e un'ora nell'equivalente DateTime utilizzando il formato, le informazioni sul formato specifiche delle impostazioni cultura e lo stile specificati. Il formato della rappresentazione di stringa deve corrispondere esattamente al formato specificato oppure viene generata un'eccezione.
ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles)

Converte la rappresentazione di intervallo specificata di una data e un'ora nell'equivalente DateTime usando la matrice di formati, le informazioni sul formato specifiche delle impostazioni cultura e lo stile specificati. Il formato della rappresentazione di stringa deve corrispondere esattamente a uno dei formati specificati oppure viene generata un'eccezione.
ParseExact(String, String, IFormatProvider, DateTimeStyles)

Converte la rappresentazione di stringa specificata di una data e un'ora nell'equivalente DateTime utilizzando il formato, le informazioni sul formato specifiche delle impostazioni cultura e lo stile specificati. Il formato della rappresentazione di stringa deve corrispondere esattamente al formato specificato oppure viene generata un'eccezione.
ParseExact(String, String, IFormatProvider)

Converte la rappresentazione di stringa specificata di una data e un'ora nell'equivalente DateTime utilizzando il formato specificato e le informazioni sul formato specifiche delle impostazioni cultura. Il formato della rappresentazione di stringa deve corrispondere esattamente al formato specificato.
ParseExact(String, String[], IFormatProvider, DateTimeStyles)

Converte la rappresentazione di stringa specificata di una data e un'ora nell'equivalente DateTime utilizzando la matrice di formati, le informazioni sul formato specifiche delle impostazioni cultura e lo stile specificati. Il formato della rappresentazione di stringa deve corrispondere esattamente a uno dei formati specificati oppure viene generata un'eccezione.
SpecifyKind(DateTime, DateTimeKind)

Crea un nuovo DateTime oggetto con lo stesso numero di tick dell'oggetto specificato DateTime, ma è designato come ora locale, ora UTC (Coordinated Universal Time) o nessuno dei due, come indicato dal valore specificato DateTimeKind .
Subtract(DateTime)

Restituisce un nuovo TimeSpan oggetto che sottrae la data e l'ora specificate dal valore di questa istanza.
Subtract(TimeSpan)

Restituisce un nuovo DateTime oggetto che sottrae la durata specificata dal valore di questa istanza.
ToBinary()

Serializza l'oggetto corrente DateTime in un valore binario a 64 bit che successivamente può essere utilizzato per ricreare l'oggetto DateTime .
ToFileTime()

Converte il valore dell'oggetto corrente DateTime in un'ora di file di Windows.
ToFileTimeUtc()

Converte il valore dell'oggetto corrente DateTime in un'ora di file di Windows.
ToLocalTime()

Converte il valore dell'oggetto corrente DateTime in ora locale.
ToLongDateString()

Converte il valore dell'oggetto corrente DateTime nella rappresentazione di stringa di data estesa equivalente.
ToLongTimeString()

Converte il valore dell'oggetto corrente DateTime nella rappresentazione di stringa di lunga durata equivalente.
ToOADate()

Converte il valore di questa istanza nella data di automazione OLE equivalente.
ToShortDateString()

Converte il valore dell'oggetto corrente DateTime nella rappresentazione di stringa di data breve equivalente.
ToShortTimeString()

Converte il valore dell'oggetto corrente DateTime nella rappresentazione di stringa di breve durata equivalente.
ToString()

Converte il valore dell'oggetto corrente DateTime nella rappresentazione di stringa equivalente utilizzando le convenzioni di formattazione delle impostazioni cultura correnti.
ToString(IFormatProvider)

Converte il valore dell'oggetto corrente DateTime nella rappresentazione di stringa equivalente utilizzando le informazioni sul formato specifiche delle impostazioni cultura specificate.
ToString(String, IFormatProvider)

Converte il valore dell'oggetto corrente DateTime nella rappresentazione di stringa equivalente utilizzando il formato specificato e le informazioni sul formato specifiche delle impostazioni cultura.
ToString(String)

Converte il valore dell'oggetto corrente DateTime nella rappresentazione di stringa equivalente utilizzando il formato specificato e le convenzioni di formattazione delle impostazioni cultura correnti.
ToUniversalTime()

Converte il valore dell'oggetto corrente DateTime in utc (Coordinated Universal Time).
TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)

Tenta di formattare il valore dell'istanza datetime corrente nell'intervallo di caratteri specificato.
TryParse(ReadOnlySpan<Char>, DateTime)

Converte l'intervallo di caratteri specificato di una data e un'ora nell'equivalente DateTime e restituisce un valore che indica se la conversione è riuscita.
TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime)

Converte la rappresentazione dell'intervallo di una data e dell'ora nell'equivalente DateTime utilizzando le informazioni sul formato e lo stile di formattazione specifiche delle impostazioni cultura specificate e restituisce un valore che indica se la conversione ha avuto esito positivo.
TryParse(String, DateTime)

Converte la rappresentazione di stringa specificata di una data e dell'ora nell'equivalente DateTime e restituisce un valore che indica se la conversione è riuscita.
TryParse(String, IFormatProvider, DateTimeStyles, DateTime)

Converte la rappresentazione di stringa specificata di una data e dell'ora nell'equivalente DateTime utilizzando le informazioni sul formato e lo stile di formattazione specifiche delle impostazioni cultura specificate e restituisce un valore che indica se la conversione è riuscita.
TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime)

Converte la rappresentazione di intervallo specificata di una data e un'ora nell'equivalente DateTime utilizzando il formato, le informazioni sul formato specifiche delle impostazioni cultura e lo stile specificati. Il formato della rappresentazione di stringa deve corrispondere esattamente al formato specificato. Il metodo restituisce un valore che indica se la conversione è riuscita.
TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTime)

Converte l'intervallo di caratteri specificato di una data e un'ora nell'equivalente DateTime e restituisce un valore che indica se la conversione è riuscita.
TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime)

Converte la rappresentazione di stringa specificata di una data e un'ora nell'equivalente DateTime utilizzando il formato, le informazioni sul formato specifiche delle impostazioni cultura e lo stile specificati. Il formato della rappresentazione di stringa deve corrispondere esattamente al formato specificato. Il metodo restituisce un valore che indica se la conversione è riuscita.
TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime)

Converte la rappresentazione di stringa specificata di una data e un'ora nell'equivalente DateTime utilizzando la matrice di formati, le informazioni sul formato specifiche delle impostazioni cultura e lo stile specificati. Il formato della rappresentazione di stringa deve corrispondere esattamente a uno dei formati specificati. Il metodo restituisce un valore che indica se la conversione è riuscita.

Operatori

Nome Descrizione
Addition(DateTime, TimeSpan)

Aggiunge un intervallo di tempo specificato a una data e un'ora specificate, producendo una nuova data e ora.
Equality(DateTime, DateTime)

Determina se due istanze specificate di DateTime sono uguali.
GreaterThan(DateTime, DateTime)

Determina se uno specificato DateTime è successivo a un altro specificato DateTime.
GreaterThanOrEqual(DateTime, DateTime)

Determina se un oggetto specificato DateTime rappresenta una data e un'ora uguali a o successive a un altro specificato DateTime.
Inequality(DateTime, DateTime)

Determina se due istanze specificate di DateTime non sono uguali.
LessThan(DateTime, DateTime)

Determina se un oggetto specificato DateTime è precedente a un altro specificato DateTime.
LessThanOrEqual(DateTime, DateTime)

Determina se un oggetto specificato DateTime rappresenta una data e un'ora uguali a o precedenti a un altro specificato DateTime.
Subtraction(DateTime, DateTime)

Sottrae una data e un'ora specificate da un'altra data e ora specificate e restituisce un intervallo di tempo.
Subtraction(DateTime, TimeSpan)

Sottrae un intervallo di tempo specificato da una data e un'ora specificate e restituisce una nuova data e ora.

Implementazioni dell'interfaccia esplicita

Nome Descrizione
IComparable.CompareTo(Object)

Confronta l'istanza corrente con un altro oggetto dello stesso tipo e restituisce un numero intero che indica se l'istanza corrente precede, segue o si trova nella stessa posizione nell'ordinamento dell'altro oggetto.
IConvertible.GetTypeCode()

Restituisce l'oggetto TypeCode per questa istanza.
IConvertible.ToBoolean(IFormatProvider)

Questa conversione non è supportata. Il tentativo di utilizzare questo metodo genera un'eccezione InvalidCastException.
IConvertible.ToByte(IFormatProvider)

Questa conversione non è supportata. Il tentativo di utilizzare questo metodo genera un'eccezione InvalidCastException.
IConvertible.ToChar(IFormatProvider)

Questa conversione non è supportata. Il tentativo di utilizzare questo metodo genera un'eccezione InvalidCastException.
IConvertible.ToDateTime(IFormatProvider)

Restituisce l'oggetto corrente DateTime .
IConvertible.ToDecimal(IFormatProvider)

Questa conversione non è supportata. Il tentativo di utilizzare questo metodo genera un'eccezione InvalidCastException.
IConvertible.ToDouble(IFormatProvider)

Questa conversione non è supportata. Il tentativo di utilizzare questo metodo genera un'eccezione InvalidCastException.
IConvertible.ToInt16(IFormatProvider)

Questa conversione non è supportata. Il tentativo di utilizzare questo metodo genera un'eccezione InvalidCastException.
IConvertible.ToInt32(IFormatProvider)

Questa conversione non è supportata. Il tentativo di utilizzare questo metodo genera un'eccezione InvalidCastException.
IConvertible.ToInt64(IFormatProvider)

Questa conversione non è supportata. Il tentativo di utilizzare questo metodo genera un'eccezione InvalidCastException.
IConvertible.ToSByte(IFormatProvider)

Questa conversione non è supportata. Il tentativo di utilizzare questo metodo genera un'eccezione InvalidCastException.
IConvertible.ToSingle(IFormatProvider)

Questa conversione non è supportata. Il tentativo di utilizzare questo metodo genera un'eccezione InvalidCastException.
IConvertible.ToType(Type, IFormatProvider)

Converte l'oggetto corrente DateTime in un oggetto di un tipo specificato.
IConvertible.ToUInt16(IFormatProvider)

Questa conversione non è supportata. Il tentativo di utilizzare questo metodo genera un'eccezione InvalidCastException.
IConvertible.ToUInt32(IFormatProvider)

Questa conversione non è supportata. Il tentativo di utilizzare questo metodo genera un'eccezione InvalidCastException.
IConvertible.ToUInt64(IFormatProvider)

Questa conversione non è supportata. Il tentativo di utilizzare questo metodo genera un'eccezione InvalidCastException.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Popola un SerializationInfo oggetto con i dati necessari per serializzare l'oggetto corrente DateTime .

Si applica a

Thread safety

Tutti i membri di questo tipo sono thread-safe. I membri che sembrano modificare lo stato dell'istanza restituiscono effettivamente una nuova istanza inizializzata con il nuovo valore. Come per qualsiasi altro tipo, la lettura e la scrittura in una variabile condivisa contenente un'istanza di questo tipo devono essere protette da un blocco per garantire la thread safety.

Vedi anche