TimeZoneInfo Classe
Definizione
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 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 |
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. |