TimeZoneInfo Classe

Definizione

Rappresenta un qualsiasi fuso orario nel mondo.

public ref class TimeZoneInfo sealed : IEquatable<TimeZoneInfo ^>, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable
public sealed class TimeZoneInfo : IEquatable<TimeZoneInfo>, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable
[System.Serializable]
public sealed class TimeZoneInfo : IEquatable<TimeZoneInfo>, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable
type TimeZoneInfo = class
    interface IEquatable<TimeZoneInfo>
    interface ISerializable
    interface IDeserializationCallback
Public NotInheritable Class TimeZoneInfo
Implements IDeserializationCallback, IEquatable(Of TimeZoneInfo), ISerializable
Ereditarietà
TimeZoneInfo
Attributi
Implementazioni

Commenti

Un fuso orario è un'area geografica nella quale si usa la stessa ora.

La classe TimeZoneInfo offre miglioramenti significativi rispetto alla classe TimeZone, che fornisce solo funzionalità limitate.

La classe TimeZone riconosce solo il fuso orario locale e può convertire gli orari tra l'ora UTC (Coordinated Universal Time) e l'ora locale. Un oggetto TimeZoneInfo può rappresentare qualsiasi fuso orario e i metodi della classe TimeZoneInfo possono essere utilizzati per convertire l'ora in un fuso orario nell'ora corrispondente in un altro fuso orario. I membri della classe TimeZoneInfo supportano le operazioni seguenti:

  • Recupero di un fuso orario già definito dal sistema operativo.

  • Enumerazione dei fusi orari disponibili in un sistema.

  • Conversione degli orari tra fusi orari diversi.

  • Creazione di un nuovo fuso orario non ancora definito dal sistema operativo.

  • Serializzazione di un fuso orario per il recupero successivo.

Nota

Un'istanza della classe TimeZoneInfo non è modificabile. Una volta che è stata creata un'istanza di un oggetto, non è possibile modificarne i valori.

Non è possibile creare un'istanza di un oggetto TimeZoneInfo usando la parola chiave new. Al contrario, è necessario chiamare uno dei membri statici della classe TimeZoneInfo illustrata nella tabella seguente.

Nome membro statico Descrizione
MetodoCreateCustomTimeZone Crea un fuso orario personalizzato dai dati forniti dall'applicazione.
MetodoFindSystemTimeZoneById Crea un'istanza di un fuso orario in base al relativo identificatore.
MetodoFromSerializedString Deserializza un valore stringa per ricreare un oggetto TimeZoneInfo serializzato in precedenza.
MetodoGetSystemTimeZones Restituisce un ReadOnlyCollection<T> enumerabile di oggetti TimeZoneInfo che rappresenta tutti i fusi orari disponibili nel sistema locale.
Proprietà Local Crea un'istanza di un oggetto TimeZoneInfo che rappresenta il fuso orario locale.
Proprietà Utc Crea un'istanza di un oggetto TimeZoneInfo che rappresenta l'area UTC.

È possibile usare il metodo CreateCustomTimeZone per creare un fuso orario non definito nel registro di sistema locale nei sistemi Windows o dalle classi del fuso orario nella libreria di ICU in Linux o MacOS. È quindi possibile usare la proprietà ToSerializedString per salvare le informazioni dell'oggetto fuso orario come stringa, che può essere archiviata in un formato accessibile all'applicazione. È possibile utilizzare il metodo FromSerializedString per convertire nuovamente una stringa serializzata in un oggetto TimeZoneInfo.

Proprietà

BaseUtcOffset

Ottiene la differenza tra l'ora solare del fuso orario corrente e l'ora UTC (Coordinated Universal Time).

DaylightName

Ottiene il nome visualizzato per l'ora legale del fuso orario corrente.

DisplayName

Ottiene il nome visualizzato generale che rappresenta il fuso orario.

Id

Ottiene l'identificatore del fuso orario.

Local

Ottiene un oggetto TimeZoneInfo che rappresenta il fuso orario locale.

StandardName

Ottiene il nome visualizzato per l'ora solare del fuso orario.

SupportsDaylightSavingTime

Ottiene un valore che indica se il fuso orario include o meno regole di applicazione dell'ora legale.

Utc

Ottiene un oggetto TimeZoneInfo che rappresenta il fuso UTC (Coordinated Universal Time).

Metodi

ClearCachedData()

Cancella i dati del fuso orario memorizzati nella cache.

ConvertTime(DateTime, TimeZoneInfo)

Converte un'ora nell'ora di un particolare fuso orario.

ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo)

Converte un'ora da un fuso orario a un altro.

ConvertTime(DateTimeOffset, TimeZoneInfo)

Converte un'ora nell'ora di un particolare fuso orario.

ConvertTimeBySystemTimeZoneId(DateTime, String)

Converte un'ora nell'ora di un fuso orario diverso in base all'identificatore del fuso orario.

ConvertTimeBySystemTimeZoneId(DateTime, String, String)

Converte un'ora da un fuso orario a un altro in base agli identificatori dei fusi orari.

ConvertTimeBySystemTimeZoneId(DateTimeOffset, String)

Converte un'ora nell'ora di un fuso orario diverso in base all'identificatore del fuso orario.

ConvertTimeFromUtc(DateTime, TimeZoneInfo)

Converte l'ora UTC (Coordinated Universal Time) nell'ora di un fuso orario specificato.

ConvertTimeToUtc(DateTime)

Converte la data e l'ora specificate in ora UTC (Coordinated Universal Time).

ConvertTimeToUtc(DateTime, TimeZoneInfo)

Converte l'ora di un fuso orario specificato in ora UTC (Coordinated Universal Time).

CreateCustomTimeZone(String, TimeSpan, String, String)

Crea un fuso orario personalizzato con un identificatore specificato, un offset dall'ora UTC (Coordinated Universal Time), un nome visualizzato e un nome visualizzato dell'ora solare.

CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[])

Crea un fuso orario personalizzato con un identificatore specificato, un offset dall'ora UTC (Coordinated Universal Time), un nome visualizzato, un nome dell'ora solare, un nome dell'ora legale e regole di applicazione per l'ora legale.

CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[], Boolean)

Crea un fuso orario personalizzato con un identificatore specificato, un offset dall'ora UTC (Coordinated Universal Time), un nome visualizzato, un nome dell'ora solare, un nome dell'ora legale, regole di applicazione per l'ora legale e un valore che indica se l'oggetto restituito riflette o meno le informazioni sull'ora legale.

Equals(Object)

Determina se l'oggetto TimeZoneInfo corrente e un altro oggetto sono uguali.

Equals(TimeZoneInfo)

Determina se l'oggetto TimeZoneInfo corrente e un altro oggetto TimeZoneInfo sono uguali.

FindSystemTimeZoneById(String)

Crea un'istanza di un nuovo oggetto TimeZoneInfo in base al relativo identificatore.

FromSerializedString(String)

Deserializza una stringa per ricreare un oggetto TimeZoneInfo serializzato originale.

GetAdjustmentRules()

Recupera una matrice di oggetti TimeZoneInfo.AdjustmentRule che vengono applicati all'oggetto TimeZoneInfo corrente.

GetAmbiguousTimeOffsets(DateTime)

Restituisce le informazioni sulle possibili date e ore alle quali possono essere mappate una data e un'ora ambigue.

GetAmbiguousTimeOffsets(DateTimeOffset)

Restituisce le informazioni sulle possibili date e ore alle quali possono essere mappate una data e un'ora ambigue.

GetHashCode()

Usato come funzione hash per algoritmi di hash e strutture dei dati, ad esempio tabelle hash.

GetSystemTimeZones()

Restituisce una raccolta ordinata di tutti i fusi orari per i quali sono disponibili informazioni nel sistema locale.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
GetUtcOffset(DateTime)

Calcola l'offset o differenza tra l'ora in questo fuso orario e l'ora UTC (Coordinated Universal Time) per una particolare data e ora.

GetUtcOffset(DateTimeOffset)

Calcola l'offset o differenza tra l'ora in questo fuso orario e l'ora UTC (Coordinated Universal Time) per una particolare data e ora.

HasSameRules(TimeZoneInfo)

Indica se l'oggetto corrente e un altro oggetto TimeZoneInfo hanno le stesse regole di regolazione.

IsAmbiguousTime(DateTime)

Determina se una data e un'ora particolari in un fuso orario specifico sono ambigue o meno e se possono essere mappate a due o più ore UTC (Coordinated Universal Time).

IsAmbiguousTime(DateTimeOffset)

Determina se una data e un'ora particolari in un fuso orario specifico sono ambigue o meno e se possono essere mappate a due o più ore UTC (Coordinated Universal Time).

IsDaylightSavingTime(DateTime)

Indica se una data e un'ora specificate rientrano nell'intervallo dell'ora legale per il fuso orario dell'oggetto TimeZoneInfo corrente.

IsDaylightSavingTime(DateTimeOffset)

Indica se una data e un'ora specificate rientrano nell'intervallo dell'ora legale per il fuso orario dell'oggetto TimeZoneInfo corrente.

IsInvalidTime(DateTime)

Indica se una data e un'ora particolari non sono valide.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToSerializedString()

Converte l'oggetto TimeZoneInfo corrente in una stringa serializzata.

ToString()

Restituisce il nome visualizzato dell'oggetto TimeZoneInfo corrente.

Implementazioni dell'interfaccia esplicita

IDeserializationCallback.OnDeserialization(Object)

Viene eseguito quando la deserializzazione di un oggetto è stata completata.

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Compila un oggetto SerializationInfo con i dati necessari per serializzare l'oggetto TimeZoneInfo corrente.

Si applica a