TimeZoneInfo.ConvertTimeBySystemTimeZoneId 方法

定義

命名空間:

System

組件:

System.Runtime.dll

根據時區識別項將時間轉換為另一時區的時間。

多載

ConvertTimeBySystemTimeZoneId(DateTime, String)	根據時區的識別項將時間轉換為另一時區的時間。
ConvertTimeBySystemTimeZoneId(DateTimeOffset, String)	根據時區的識別項將時間轉換為另一時區的時間。
ConvertTimeBySystemTimeZoneId(DateTime, String, String)	根據時區識別項將時間從一個時區轉換為另一個時區。

ConvertTimeBySystemTimeZoneId(DateTime, String)

來源:

TimeZoneInfo.cs

根據時區的識別項將時間轉換為另一時區的時間。

public:
 static DateTime ConvertTimeBySystemTimeZoneId(DateTime dateTime, System::String ^ destinationTimeZoneId);

public static DateTime ConvertTimeBySystemTimeZoneId (DateTime dateTime, string destinationTimeZoneId);

static member ConvertTimeBySystemTimeZoneId : DateTime * string -> DateTime

Public Shared Function ConvertTimeBySystemTimeZoneId (dateTime As DateTime, destinationTimeZoneId As String) As DateTime

參數

dateTime

DateTime

要轉換的日期和時間。

destinationTimeZoneId

String

目的地時區的識別項。

傳回

DateTime

目的地時區中的日期與時間。

例外狀況

ArgumentNullException

destinationTimeZoneId 為 null。

InvalidTimeZoneException

找到時區識別項，但登錄資料已損毀。

SecurityException

處理序沒有必要權限可讀取包含時區資訊的登錄機碼。

TimeZoneNotFoundException

在本機系統上找不到 destinationTimeZoneId 識別項。

備註

執行轉換時， ConvertTimeBySystemTimeZoneId 此方法會套用時區中 destinationTimeZoneId 生效的任何調整規則。

這個多載與呼叫 ConvertTime(DateTime, TimeZoneInfo) 方法大致相同，不同之處在于它可讓您依其識別碼指定目的地時區，而不是物件參考。 當您必須轉換時間而不擷取對應的時區物件，而且您不需要知道轉換的時間是標準時間還是日光節約時間時，這個方法最有用。

方法 ConvertTimeBySystemTimeZoneId(DateTime, String) 會從 dateTime 參數 Kind 的 屬性值判斷來源時區，如下表所示。

Kind 屬性值	來源時區	方法行為
DateTimeKind.Local	Local	將當地時間轉換為 中的 destinationTimeZone 時間。
DateTimeKind.Utc	Utc	將國際標準時間 (UTC) 轉換為 中的 destinationTimeZone 時間。
DateTimeKind.Unspecified	假設為 Local 。	將當地時間轉換為 中的 destinationTimeZone 時間。

傳 Kind 回 DateTime 值的 屬性會設定如下表所示。

條件	傳回的 Kind 屬性值
destinationTimeZone 為 TimeZoneInfo.Utc.Id。	DateTimeKind.Utc
任何其他 destinationTimeZone 值。	DateTimeKind.Unspecified

如果參數的值是模棱兩可的 dateTime 當地時間，則會解譯為標準時間。 dateTime如果參數是不正確當地時間，這個方法會擲回 ArgumentException 。

如果轉換 dateTime 結果的日期和時間值早于 DateTime.MinValue 或 晚 DateTime.MaxValue ，則此方法會分別傳回 DateTime.MinValue 或 DateTime.MaxValue 。

這個方法會擷取時區的相關資訊，其識別碼是由 destinationTimeZoneId Windows 系統上登錄的參數所指定，以及從 Linux 和 macOS 上的 ICU 程式庫 指定。 它無法擷取使用 方法建立的 CreateCustomTimeZone 時區物件。 參數 destinationTimeZoneId 必須完全對應到時區的識別碼長度，但不會在發生成功比對的情況下對應;也就是說，與時區識別碼的比較 destinationTimeZoneId 不區分大小寫。

另請參閱

• 在時區之間轉換時間

ConvertTimeBySystemTimeZoneId(DateTimeOffset, String)

來源:

TimeZoneInfo.cs

根據時區的識別項將時間轉換為另一時區的時間。

public:
 static DateTimeOffset ConvertTimeBySystemTimeZoneId(DateTimeOffset dateTimeOffset, System::String ^ destinationTimeZoneId);

public static DateTimeOffset ConvertTimeBySystemTimeZoneId (DateTimeOffset dateTimeOffset, string destinationTimeZoneId);

static member ConvertTimeBySystemTimeZoneId : DateTimeOffset * string -> DateTimeOffset

Public Shared Function ConvertTimeBySystemTimeZoneId (dateTimeOffset As DateTimeOffset, destinationTimeZoneId As String) As DateTimeOffset

參數

dateTimeOffset

DateTimeOffset

要轉換的日期和時間。

destinationTimeZoneId

String

目的地時區的識別項。

傳回

DateTimeOffset

目的地時區中的日期與時間。

例外狀況

ArgumentNullException

destinationTimeZoneId 為 null。

InvalidTimeZoneException

找到時區識別項，但登錄資料已損毀。

SecurityException

處理序沒有必要權限可讀取包含時區資訊的登錄機碼。

TimeZoneNotFoundException

在本機系統上找不到 destinationTimeZoneId 識別項。

備註

執行轉換時， ConvertTimeBySystemTimeZoneId 此方法會套用時區中 destinationTimeZoneId 生效的任何調整規則。

這個多載與呼叫 ConvertTime(DateTimeOffset, TimeZoneInfo) 方法相同，不同之處在于它可讓您依其識別碼指定目的地時區，而不是由物件參考指定。 當您必須轉換時間而不擷取對應的時區物件，而且您不需要知道轉換的時間是標準時間還是日光節約時間時，這個方法最有用。

dateTimeOffset因為 參數代表日期和時間，以及該時間與國際標準時間的位移 (UTC) ，所以它不能代表模棱兩可的時間或不正確時間。

這個方法會從 Windows 系統上的登錄和 Linux 和 macOS 上的ICU 程式庫擷取其識別碼所 destinationTimeZoneId 指定的時區。 它無法擷取使用 方法建立的 CreateCustomTimeZone 時區物件。 參數 destinationTimeZoneId 必須完全對應到時區的識別碼長度，但不會在發生成功比對的情況下對應;也就是說，與時區識別碼的比較 destinationTimeZoneId 不區分大小寫。

在將值轉換成 dateTimeOffset 目的地時區的時間時，此方法會考慮目的地時區中生效的任何調整規則。

如果轉換 dateTimeOffset 結果的日期和時間值早于 DateTimeOffset.MinValue 或 晚 DateTimeOffset.MaxValue ，則此方法會分別傳回 DateTimeOffset.MinValue 或 DateTimeOffset.MaxValue 。

另請參閱

• 在時區之間轉換時間

ConvertTimeBySystemTimeZoneId(DateTime, String, String)

來源:

TimeZoneInfo.cs

根據時區識別項將時間從一個時區轉換為另一個時區。

public:
 static DateTime ConvertTimeBySystemTimeZoneId(DateTime dateTime, System::String ^ sourceTimeZoneId, System::String ^ destinationTimeZoneId);

public static DateTime ConvertTimeBySystemTimeZoneId (DateTime dateTime, string sourceTimeZoneId, string destinationTimeZoneId);

static member ConvertTimeBySystemTimeZoneId : DateTime * string * string -> DateTime

Public Shared Function ConvertTimeBySystemTimeZoneId (dateTime As DateTime, sourceTimeZoneId As String, destinationTimeZoneId As String) As DateTime

參數

dateTime

DateTime

要轉換的日期和時間。

sourceTimeZoneId

String

來源時區的識別項。

destinationTimeZoneId

String

目的地時區的識別項。

傳回

DateTime

目的地時區中的日期和時間，對應至來源時區中的 dateTime 參數。

例外狀況

ArgumentException

dateTime 參數的 Kind 屬性未對應至來源時區。

-或-

dateTime 是來源時區中的無效時間。

ArgumentNullException

sourceTimeZoneId 為 null。

-或-

destinationTimeZoneId 為 null。

InvalidTimeZoneException

找到時區識別項，但登錄資料已損毀。

SecurityException

使用者沒有必要權限可讀取保留時區資料的登錄機碼。

TimeZoneNotFoundException

在本機系統上找不到 sourceTimeZoneId 識別項。

-或-

在本機系統上找不到 destinationTimeZoneId 識別項。

範例

下列範例會 TimeZoneInfo.ConvertTimeBySystemTimeZoneId(DateTime, String, String) 使用 方法來顯示對應至全球八個城市當地系統時間的時間。

DateTime currentTime = DateTime.Now;
Console.WriteLine("Current Times:");
Console.WriteLine();
Console.WriteLine("Los Angeles: {0}", 
                  TimeZoneInfo.ConvertTimeBySystemTimeZoneId(currentTime, TimeZoneInfo.Local.Id, "Pacific Standard Time"));
Console.WriteLine("Chicago: {0}", 
                  TimeZoneInfo.ConvertTimeBySystemTimeZoneId(currentTime, TimeZoneInfo.Local.Id, "Central Standard Time"));
Console.WriteLine("New York: {0}", 
                  TimeZoneInfo.ConvertTimeBySystemTimeZoneId(currentTime, TimeZoneInfo.Local.Id, "Eastern Standard Time"));
Console.WriteLine("London: {0}", 
                  TimeZoneInfo.ConvertTimeBySystemTimeZoneId(currentTime, TimeZoneInfo.Local.Id, "GMT Standard Time"));
Console.WriteLine("Moscow: {0}", 
                  TimeZoneInfo.ConvertTimeBySystemTimeZoneId(currentTime, TimeZoneInfo.Local.Id, "Russian Standard Time"));
Console.WriteLine("New Delhi: {0}", 
                  TimeZoneInfo.ConvertTimeBySystemTimeZoneId(currentTime, TimeZoneInfo.Local.Id, "India Standard Time"));
Console.WriteLine("Beijing: {0}", 
                  TimeZoneInfo.ConvertTimeBySystemTimeZoneId(currentTime, TimeZoneInfo.Local.Id, "China Standard Time"));
Console.WriteLine("Tokyo: {0}", 
                  TimeZoneInfo.ConvertTimeBySystemTimeZoneId(currentTime, TimeZoneInfo.Local.Id, "Tokyo Standard Time"));

let currentTime = DateTime.Now
printfn "Current Times:\n"
printfn $"""Los Angeles: {TimeZoneInfo.ConvertTimeBySystemTimeZoneId(currentTime, TimeZoneInfo.Local.Id, "Pacific Standard Time")}"""
printfn $"""Chicago: {TimeZoneInfo.ConvertTimeBySystemTimeZoneId(currentTime, TimeZoneInfo.Local.Id, "Central Standard Time")}"""
printfn $"""New York: {TimeZoneInfo.ConvertTimeBySystemTimeZoneId(currentTime, TimeZoneInfo.Local.Id, "Eastern Standard Time")}"""
printfn $"""London: {TimeZoneInfo.ConvertTimeBySystemTimeZoneId(currentTime, TimeZoneInfo.Local.Id, "GMT Standard Time")}"""
printfn $"""Moscow: {TimeZoneInfo.ConvertTimeBySystemTimeZoneId(currentTime, TimeZoneInfo.Local.Id, "Russian Standard Time")}"""
printfn $"""New Delhi: {TimeZoneInfo.ConvertTimeBySystemTimeZoneId(currentTime, TimeZoneInfo.Local.Id, "India Standard Time")}"""
printfn $"""Beijing: {TimeZoneInfo.ConvertTimeBySystemTimeZoneId(currentTime, TimeZoneInfo.Local.Id, "China Standard Time")}"""
printfn $"""Tokyo: {TimeZoneInfo.ConvertTimeBySystemTimeZoneId(currentTime, TimeZoneInfo.Local.Id, "Tokyo Standard Time")}"""

Dim currentTime As Date = Date.Now
Console.WriteLine("Current Times:")
Console.WriteLine()
Console.WriteLine("Los Angeles: {0}", _
                  TimeZoneInfo.ConvertTimeBySystemTimeZoneId(currentTime, TimeZoneInfo.Local.Id, "Pacific Standard Time"))
Console.WriteLine("Chicago: {0}", _ 
                  TimeZoneInfo.ConvertTimeBySystemTimeZoneId(currentTime, TimeZoneInfo.Local.Id, "Central Standard Time"))
Console.WriteLine("New York: {0}", _
                  TimeZoneInfo.ConvertTimeBySystemTimeZoneId(currentTime, TimeZoneInfo.Local.Id, "Eastern Standard Time"))
Console.WriteLine("London: {0}", _
                  TimeZoneInfo.ConvertTimeBySystemTimeZoneId(currentTime, TimeZoneInfo.Local.Id, "GMT Standard Time"))
Console.WriteLine("Moscow: {0}", _
                  TimeZoneInfo.ConvertTimeBySystemTimeZoneId(currentTime, TimeZoneInfo.Local.Id, "Russian Standard Time"))
Console.WriteLine("New Delhi: {0}", _
                  TimeZoneInfo.ConvertTimeBySystemTimeZoneId(currentTime, TimeZoneInfo.Local.Id, "India Standard Time"))
Console.WriteLine("Beijing: {0}", _
                  TimeZoneInfo.ConvertTimeBySystemTimeZoneId(currentTime, TimeZoneInfo.Local.Id, "China Standard Time"))
Console.WriteLine("Tokyo: {0}", _
                  TimeZoneInfo.ConvertTimeBySystemTimeZoneId(currentTime, TimeZoneInfo.Local.Id, "Tokyo Standard Time"))

備註

執行轉換時， ConvertTimeBySystemTimeZoneId 此方法會套用時區中 destinationTimeZoneId 生效的任何調整規則。

雖然它與 TimeZoneInfo.ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo) 方法類似，但您可以使用 TimeZoneInfo.ConvertTimeBySystemTimeZoneId(DateTime, String, String) 其識別碼來指定來源和目的地時區，而不是其 TimeZoneInfo 物件。 當您必須轉換時間而不擷取對應的時區物件，而且您不需要知道轉換的時間是標準時間還是日光節約時間時，這個方法最有用。

這個方法會擷取其識別碼是 sourceTimeZoneId Windows 系統上登錄的 和 destinationTimeZoneId 參數，以及從 Linux 和 macOS 上的 ICU 程式庫 擷取時區。 它無法擷取使用 方法建立的 CreateCustomTimeZone 時區物件。

參數的 KinddateTime 屬性值必須對應至 sourceTimeZoneId 參數，如下表所示。

DateTime.Kind 值	sourceTimeZone 值	方法行為
DateTimeKind.Utc	TimeZoneInfo.Utc.Id等於 。	dateTime轉換為目的地時區的時間。
DateTimeKind.Utc	Does not equal TimeZoneInfo.Utc.Id。	擲回 ArgumentException 。
DateTimeKind.Local	TimeZoneInfo.Local.Id等於 。	dateTime轉換為目的地時區的時間。
DateTimeKind.Local	Does not equal TimeZoneInfo.Local.Id。	擲回 ArgumentException 。
DateTimeKind.Unspecified	任何。	dateTime轉換為目的地時區的時間。

因為它依賴對 方法的 FindSystemTimeZoneById 呼叫，所以 ConvertTimeBySystemTimeZoneId 方法會執行不區分大小寫的搜尋，以找出對應至 sourceTimeZoneId 和 destinationTimeZoneId 的時區。

如果參數的值 dateTime 在來源時區中是模棱兩可的時間，則會解譯為標準時間。 dateTime如果參數在來源時區中是不正確時間，這個方法會擲回 ArgumentException 。

Kind除非目的地時區是國際標準時間 (UTC) ，否則傳 DateTime 回值的 屬性會設定 DateTimeKind.Unspecified 為 ，在此情況下，它會設定為 DateTimeKind.Utc 。

另請參閱

• 在時區之間轉換時間