TimeZoneInfo Classe

Definizione

Spazio dei nomi:

System

Assembly:

netstandard.dll, System.Runtime.dll

Origine:

TimeZoneInfo.cs

Rappresenta 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

type TimeZoneInfo = class
    interface IEquatable<TimeZoneInfo>
    interface IDeserializationCallback
    interface ISerializable

Public NotInheritable Class TimeZoneInfo
Implements IDeserializationCallback, IEquatable(Of TimeZoneInfo), ISerializable

Ereditarietà

Object

TimeZoneInfo

Implementazioni

IEquatable<TimeZoneInfo> IDeserializationCallback ISerializable

Commenti

Un fuso orario è un'area geografica in cui viene usata la stessa ora.

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

La TimeZone classe riconosce solo il fuso orario locale e può convertire le ore 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 utilizzati 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 di orari 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.

Annotazioni

Un'istanza della TimeZoneInfo classe non è modificabile. Dopo aver creato 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 oggetto enumerabile ReadOnlyCollection<T> di TimeZoneInfo oggetti che rappresenta tutti i fusi orari disponibili nel sistema locale.
Local proprietà	Crea un'istanza di un TimeZoneInfo oggetto che rappresenta il fuso orario locale.
Utc proprietà	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 utilizzare la ToSerializedString() proprietà per salvare le informazioni dell'oggetto fuso orario come stringa, che può essere archiviata in una forma accessibile all'applicazione. È possibile utilizzare il FromSerializedString metodo per convertire una stringa serializzata in un TimeZoneInfo oggetto .

Proprietà

Nome	Descrizione
BaseUtcOffset	Ottiene la differenza di ora 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 TimeZoneInfo oggetto 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 dispone di regole per l'ora legale.
Utc	Ottiene un TimeZoneInfo oggetto che rappresenta il fuso orario UTC (Coordinated Universal Time).

Metodi

Nome	Descrizione
ClearCachedData()	Cancella i dati del fuso orario memorizzati nella cache.
ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo)	Converte un'ora da un fuso orario a un altro.
ConvertTime(DateTime, TimeZoneInfo)	Converte un'ora nell'ora in un particolare fuso orario.
ConvertTime(DateTimeOffset, TimeZoneInfo)	Converte un'ora nell'ora in un particolare fuso orario.
ConvertTimeBySystemTimeZoneId(DateTime, String, String)	Converte un'ora da un fuso orario a un altro in base agli identificatori del fuso orario.
ConvertTimeBySystemTimeZoneId(DateTime, String)	Converte un'ora nell'ora in un altro fuso orario in base all'identificatore del fuso orario.
ConvertTimeBySystemTimeZoneId(DateTimeOffset, String)	Converte un'ora nell'ora in un altro fuso orario in base all'identificatore del fuso orario.
ConvertTimeFromUtc(DateTime, TimeZoneInfo)	Converte un'ora UTC (Coordinated Universal Time) nell'ora in un fuso orario specificato.
ConvertTimeToUtc(DateTime, TimeZoneInfo)	Converte l'ora in un fuso orario specificato in utc (Coordinated Universal Time).
ConvertTimeToUtc(DateTime)	Converte la data e l'ora specificate in utc (Coordinated Universal Time).
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 di ora solare, un nome dell'ora legale, regole dell'ora legale e un valore che indica se l'oggetto restituito riflette le informazioni sull'ora legale.
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 di ora solare, un nome dell'ora legale e le regole dell'ora legale.
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.
Equals(Object)	Determina se l'oggetto corrente TimeZoneInfo e un altro oggetto sono uguali.
Equals(TimeZoneInfo)	Determina se l'oggetto corrente TimeZoneInfo e un altro TimeZoneInfo oggetto sono uguali.
FindSystemTimeZoneById(String)	Restituisce un TimeZoneInfo oggetto in base al relativo identificatore.
FromSerializedString(String)	Deserializza una stringa per ricreare un oggetto serializzato TimeZoneInfo originale.
GetAdjustmentRules()	Recupera una matrice di TimeZoneInfo.AdjustmentRule oggetti applicabili all'oggetto corrente TimeZoneInfo .
GetAmbiguousTimeOffsets(DateTime)	Restituisce informazioni sulle date e le ore possibili a cui è possibile eseguire il mapping di una data e un'ora ambigue.
GetAmbiguousTimeOffsets(DateTimeOffset)	Restituisce informazioni sulle date e le ore possibili a cui è possibile eseguire il mapping di una data e un'ora ambigue.
GetHashCode()	Funge da funzione hash per algoritmi hash e strutture di dati, ad esempio tabelle hash.
GetSystemTimeZones()	Restituisce una raccolta ordinata di tutti i fusi orari relativi alle informazioni disponibili nel sistema locale.
GetSystemTimeZones(Boolean)	Restituisce un oggetto ReadOnlyCollection<T> contenente tutti i timezone validi dal computer locale. Questo metodo non genera timeZoneNotFoundException o InvalidTimeZoneException.
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
GetUtcOffset(DateTime)	Calcola l'offset o la differenza tra l'ora in questo fuso orario e l'ora UTC (Coordinated Universal Time) per una data e un'ora specifiche.
GetUtcOffset(DateTimeOffset)	Calcola l'offset o la differenza tra l'ora in questo fuso orario e l'ora UTC (Coordinated Universal Time) per una data e un'ora specifiche.
HasSameRules(TimeZoneInfo)	Indica se l'oggetto corrente e un altro TimeZoneInfo oggetto hanno le stesse regole di regolazione.
IsAmbiguousTime(DateTime)	Determina se una determinata data e ora in un particolare fuso orario è ambigua e può essere mappata a due o più ore UTC (Coordinated Universal Time).
IsAmbiguousTime(DateTimeOffset)	Determina se una determinata data e ora in un particolare fuso orario è ambigua e può essere mappata a due o più ore UTC (Coordinated Universal Time).
IsDaylightSavingTime(DateTime)	Indica se una data e un'ora specificate rientrano nell'intervallo di ora legale per il fuso orario dell'oggetto corrente TimeZoneInfo .
IsDaylightSavingTime(DateTimeOffset)	Indica se una data e un'ora specificate rientrano nell'intervallo di ora legale per il fuso orario dell'oggetto corrente TimeZoneInfo .
IsInvalidTime(DateTime)	Indica se una determinata data e ora non è valida.
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
ToSerializedString()	Converte l'oggetto corrente TimeZoneInfo in una stringa serializzata.
ToString()	Restituisce il nome visualizzato dell'oggetto corrente TimeZoneInfo .
TryConvertIanaIdToWindowsId(String, String)	Prova a convertire un ID fuso orario IANA in un ID Windows.
TryConvertWindowsIdToIanaId(String, String, String)	Prova a convertire un ID fuso orario di Windows in un ID IANA.
TryConvertWindowsIdToIanaId(String, String)	Prova a 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

Nome	Descrizione
IDeserializationCallback.OnDeserialization(Object)	Viene eseguito quando la deserializzazione di un oggetto è stata completata.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Popola un SerializationInfo oggetto con i dati necessari per serializzare l'oggetto corrente TimeZoneInfo .