Condividi tramite


TimeZoneInfo Classe

Definizione

Rappresenta un qualsiasi fuso orario nel mondo.

public ref class TimeZoneInfo sealed : IEquatable<TimeZoneInfo ^>
public ref class TimeZoneInfo sealed : IEquatable<TimeZoneInfo ^>, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable
public sealed class TimeZoneInfo : IEquatable<TimeZoneInfo>
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>
type TimeZoneInfo = class
    interface IEquatable<TimeZoneInfo>
    interface IDeserializationCallback
    interface ISerializable
type TimeZoneInfo = class
    interface IEquatable<TimeZoneInfo>
    interface ISerializable
    interface IDeserializationCallback
type TimeZoneInfo = class
    interface IDeserializationCallback
    interface ISerializable
    interface IEquatable<TimeZoneInfo>
[<System.Serializable>]
type TimeZoneInfo = class
    interface IEquatable<TimeZoneInfo>
    interface ISerializable
    interface IDeserializationCallback
Public NotInheritable Class TimeZoneInfo
Implements IEquatable(Of TimeZoneInfo)
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 TimeZoneInfo classe offre miglioramenti significativi sulla TimeZone classe, che offre solo funzionalità limitate.

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

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

  • Enumerazione dei fusi orari disponibili in un sistema.

  • Conversione dei tempi tra fusi orari diversi.

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

  • Serializzazione di un fuso orario per il recupero successivo.

Nota

Un'istanza TimeZoneInfo della classe non è modificabile. Una volta creata un'istanza di un oggetto, i relativi valori non possono essere modificati.

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

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

È possibile usare il CreateCustomTimeZone metodo per creare un fuso orario non definito nel Registro di sistema locale nei sistemi Windows o dai dati del fuso orario della libreria ICU in Linux o macOS. È quindi possibile usare la proprietà per salvare le ToSerializedString informazioni del fuso orario come stringa, che può essere archiviata in una forma accessibile all'applicazione. È possibile usare il FromSerializedString metodo per convertire una stringa serializzata in un TimeZoneInfo oggetto.

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.

HasIanaId

Restituisce true se questo oggetto TimeZoneInfo ha un ID IANA.

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(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
Equals(TimeZoneInfo)

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

FindSystemTimeZoneById(String)

Restituisce un TimeZoneInfo oggetto 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.

GetSystemTimeZones(Boolean)

Restituisce un ReadOnlyCollection<T> oggetto contenente tutti i timezone validi dal computer locale. Questo metodo non genera TimeZoneNotFoundException o InvalidTimeZoneException.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(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.

(Ereditato da Object)
ToSerializedString()

Converte l'oggetto TimeZoneInfo corrente in una stringa serializzata.

ToString()

Restituisce il nome visualizzato dell'oggetto TimeZoneInfo corrente.

TryConvertIanaIdToWindowsId(String, String)

Tenta di convertire un ID fuso orario IANA in un ID Windows.

TryConvertWindowsIdToIanaId(String, String)

Tenta di convertire un ID fuso orario di Windows in un ID IANA.

TryConvertWindowsIdToIanaId(String, String, String)

Tenta di convertire un ID fuso orario di Windows in un ID IANA.

TryFindSystemTimeZoneById(String, TimeZoneInfo)

Recupera un TimeZoneInfo oggetto in base al nome del fuso orario.

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