TimeZoneInfo.ConvertTimeBySystemTimeZoneId メソッド

ソース:

TimeZoneInfo.cs

ソース:

TimeZoneInfo.cs

ソース:

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

パラメーター

戻り値

変換先タイム ゾーンでの日付と時刻。

例外

注釈

変換を実行するときに、 メソッドは ConvertTimeBySystemTimeZoneId 、タイム ゾーンで有効な調整規則を destinationTimeZoneId 適用します。

このオーバーロードは、 メソッドの ConvertTime(DateTime, TimeZoneInfo) 呼び出しとほぼ同じですが、オブジェクト参照ではなく識別子で宛先タイム ゾーンを指定できる点が除きます。 このメソッドは、それに対応するタイム ゾーン オブジェクトを取得せずに時刻を変換する必要があり、変換された時刻が標準時間か夏時間かを知る必要がない場合に最も便利です。

メソッドはConvertTimeBySystemTimeZoneId(DateTime, String)、次の表に示すように、パラメーターKindの プロパティのdateTime値からソース タイム ゾーンを決定します。

返されるDateTime値の プロパティはKind、次の表に示すように設定されます。

パラメーターの値が dateTime あいまいな現地時刻の場合は、標準時として解釈されます。 パラメーターが dateTime 無効なローカル時刻の場合、このメソッドは を ArgumentExceptionスローします。

の変換の結果、より前またはそれより後DateTime.MinValueDateTime.MaxValueの日付と時刻のdateTime値が返される場合、このメソッドは、それぞれ または DateTime.MaxValueを返DateTime.MinValueします。

このメソッドは、Windows システムのレジストリから、および Linux および macOS 上の ICU ライブラリから、 パラメーターでdestinationTimeZoneId指定された識別子を持つタイム ゾーンに関する情報を取得します。 メソッドを使用して作成されたタイム ゾーン オブジェクトを CreateCustomTimeZone 取得することはできません。 パラメーターは destinationTimeZoneId 、タイム ゾーンの識別子の長さに正確に対応する必要がありますが、一致が正常に行われるには、大文字と小文字は区別されません。つまり、タイム ゾーン識別子との比較 destinationTimeZoneId では大文字と小文字が区別されません。

こちらもご覧ください

• タイム ゾーン間の時刻の変換

ソース:

TimeZoneInfo.cs

ソース:

TimeZoneInfo.cs

ソース:

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

パラメーター

戻り値

変換先タイム ゾーンでの日付と時刻。

例外

注釈

変換を実行するときに、 メソッドは ConvertTimeBySystemTimeZoneId 、タイム ゾーンで有効な調整規則を destinationTimeZoneId 適用します。

このオーバーロードは、 メソッドの ConvertTime(DateTimeOffset, TimeZoneInfo) 呼び出しと同じですが、オブジェクト参照ではなく識別子で宛先タイム ゾーンを指定できる点が除きます。 このメソッドは、それに対応するタイム ゾーン オブジェクトを取得せずに時刻を変換する必要があり、変換された時刻が標準時間か夏時間かを知る必要がない場合に最も便利です。

パラメーターは dateTimeOffset 、世界協定時刻 (UTC) からのその時刻のオフセットと共に日付と時刻を表すので、あいまいな時刻または無効な時刻を表すことはできません。

このメソッドは、Windows システムのレジストリから、および Linux および macOS の ICU ライブラリから、 パラメーターでdestinationTimeZoneId指定された識別子を持つタイム ゾーンを取得します。 メソッドを使用して作成されたタイム ゾーン オブジェクトを CreateCustomTimeZone 取得することはできません。 パラメーターは destinationTimeZoneId 、タイム ゾーンの識別子の長さに正確に対応する必要がありますが、一致が正常に行われるには、大文字と小文字は区別されません。つまり、タイム ゾーン識別子との比較 destinationTimeZoneId では大文字と小文字が区別されません。

この値を dateTimeOffset 変換先のタイム ゾーンの時刻に変換する場合、メソッドは宛先タイム ゾーンで有効な調整規則を考慮します。

の変換の結果、より前またはそれより後DateTimeOffset.MinValueDateTimeOffset.MaxValueの日付と時刻のdateTimeOffset値が返される場合、このメソッドは、それぞれ または DateTimeOffset.MaxValueを返DateTimeOffset.MinValueします。

こちらもご覧ください

• タイム ゾーン間の時刻の変換

ソース:

TimeZoneInfo.cs

ソース:

TimeZoneInfo.cs

ソース:

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 パラメーターに対応する、変換先タイム ゾーンでの日付と時刻。

例外

例

次の例では、 メソッドを TimeZoneInfo.ConvertTimeBySystemTimeZoneId(DateTime, String, String) 使用して、世界の 8 都市のローカル システム時刻に対応する時刻を表示します。

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 指定できます。 このメソッドは、それに対応するタイム ゾーン オブジェクトを取得せずに時刻を変換する必要があり、変換された時刻が標準時間か夏時間かを知る必要がない場合に最も便利です。

このメソッドは、Windows システムのレジストリから、および Linux および destinationTimeZoneId macOS の ICU ライブラリから、 および パラメーターである識別子sourceTimeZoneIdを持つタイム ゾーンを取得します。 メソッドを使用して作成されたタイム ゾーン オブジェクトを CreateCustomTimeZone 取得することはできません。

パラメーターの プロパティの Kind 値は、次の dateTime 表に示すように、 パラメーターに sourceTimeZoneId 対応している必要があります。

メソッドの呼び出しにFindSystemTimeZoneById依存するため、 ConvertTimeBySystemTimeZoneId メソッドは 大文字と小文字を区別しない検索を実行して、 と destinationTimeZoneIdに対応するタイム ゾーンをsourceTimeZoneId検索します。

パラメーターの dateTime 値がソース タイム ゾーンのあいまいな時刻である場合は、標準時刻として解釈されます。 パラメーターが dateTime ソース タイム ゾーンの無効な時刻である場合、このメソッドは を ArgumentExceptionスローします。

戻りDateTime値の プロパティはKind、変換先のタイム ゾーンが協定世界時 (UTC) でない限り に設定DateTimeKind.Unspecifiedされ、その場合は にDateTimeKind.Utc設定されます。

こちらもご覧ください

• タイム ゾーン間の時刻の変換