DateTime Struct

Definizione

Spazio dei nomi:: System

Assembly:: mscorlib.dll, System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

Commenti e suggerimenti

Questa pagina è stata utile?