Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo TimeZoneInfo.ConvertTimeBySystemTimeZoneId (DateTimeOffset, String)

 

Data di pubblicazione: ottobre 2016

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

Spazio dei nomi:   System
Assembly:  mscorlib (in mscorlib.dll)

public static DateTimeOffset ConvertTimeBySystemTimeZoneId(
	DateTimeOffset dateTimeOffset,
	string destinationTimeZoneId
)

Parametri

dateTimeOffset
Type: System.DateTimeOffset

Data e ora da convertire.

destinationTimeZoneId
Type: System.String

Identificatore del fuso orario di destinazione.

Valore restituito

Type: System.DateTimeOffset

Data e ora nel fuso orario di destinazione.

Exception Condition
ArgumentNullException

destinationTimeZoneId è null.

InvalidTimeZoneException

L'identificatore del fuso orario è stato trovato, ma i dati del Registro di sistema sono danneggiati.

SecurityException

Il processo non ha le autorizzazioni necessarie per leggere dalla chiave del Registro di sistema che contiene le informazioni sul fuso orario.

TimeZoneNotFoundException

Identificatore destinationTimeZoneId non trovato nel sistema locale.

Quando si esegue la conversione, il ConvertTimeBySystemTimeZoneId metodo si applica a tutte le regole di regolazione attiva nel destinationTimeZoneId fuso orario.

Questo overload è identico alla chiamata di ConvertTime(DateTime, TimeZoneInfo) metodo, ad eccezione del fatto che consente di specificare il fuso orario di destinazione tramite il relativo identificatore anziché tramite un riferimento all'oggetto. Questo metodo è particolarmente utile quando è necessario convertire un'ora senza recuperare l'oggetto fuso orario che corrisponde a tale e non è necessario sapere se l'ora convertita standard o l'ora legale.

Poiché il dateTimeOffset rappresenta una data e dall'ora Coordinated Universal Time (UTC) di offset dell'ora, insieme a quel momento, non può rappresentare un'ora ambigua o un'ora non valida.

Questo metodo recupera il fuso orario, il cui identificatore è specificato per il destinationTimeZoneId parametro dal Registro di sistema. Non è possibile recuperare un oggetto fuso orario che viene creato utilizzando il CreateCustomTimeZone metodo. Il destinationTimeZoneId parametro deve corrispondere esattamente alla chiave di registro di sistema del fuso orario in lunghezza, ma non nel caso, per trovare una corrispondenza ha esito positivo si verifichi; vale a dire, il confronto di destinationTimeZoneId con fuso orario è tra maiuscole e minuscole degli identificatori.

La conversione di dateTimeOffset valore con l'ora nel fuso orario di destinazione, il metodo prende in considerazione tutte le regole di regolazione attiva fuso orario di destinazione.

Se la conversione di dateTimeOffset restituisce un valore di data e ora precedente a DateTimeOffset.MinValue o successivo a DateTimeOffset.MaxValue, questo metodo restituisce DateTimeOffset.MinValue o DateTimeOffset.MaxValue, rispettivamente.

.NET Framework
Disponibile da 3.5
Torna all'inizio
Mostra: