方法: TimeZoneInfo オブジェクトを取得する

[アーティクル]
03/16/2024

TimeZoneInfo オブジェクトを取得する最も一般的な方法は、レジストリからそれに関する情報を取得することです。オブジェクトを取得するには、レジストリ内を検索する static (Visual Basic では Shared) TimeZoneInfo.FindSystemTimeZoneById メソッドを呼び出します。メソッドによってスローされる例外 (特に、タイムゾーンがレジストリで定義されていない場合にスローされる TimeZoneNotFoundException) を処理します。

Note

.NET 8 以降では、TimeZoneInfo.FindSystemTimeZoneById は、新しいオブジェクトをインスタンス化するのではなく、キャッシュされた TimeZoneInfo オブジェクトを返します。詳細については、「FindSystemTimeZoneById が新しいオブジェクトを返さない」を参照してください。

例

次のコードでは、東部標準時のタイムゾーンを表す TimeZoneInfo オブジェクトを取得し、現地時刻に対応する東部標準時の時刻を表示します。

DateTime timeNow = DateTime.Now;
try
{
    TimeZoneInfo easternZone = TimeZoneInfo.FindSystemTimeZoneById("Eastern Standard Time");
    DateTime easternTimeNow = TimeZoneInfo.ConvertTime(
        timeNow,
        TimeZoneInfo.Local,
        easternZone
        );
    Console.WriteLine("{0} {1} corresponds to {2} {3}.",
                      timeNow,
                      TimeZoneInfo.Local.IsDaylightSavingTime(timeNow) ?
                                TimeZoneInfo.Local.DaylightName :
                                TimeZoneInfo.Local.StandardName,
                      easternTimeNow,
                      easternZone.IsDaylightSavingTime(easternTimeNow) ?
                                  easternZone.DaylightName :
                                  easternZone.StandardName);
}
// Handle exception
//
// As an alternative to simply displaying an error message, an alternate Eastern
// Standard Time TimeZoneInfo object could be instantiated here either by restoring
// it from a serialized string or by providing the necessary data to the
// CreateCustomTimeZone method.
catch (TimeZoneNotFoundException)
{
    Console.WriteLine("The Eastern Standard Time Zone cannot be found on the local system.");
}
catch (InvalidTimeZoneException)
{
    Console.WriteLine("The Eastern Standard Time Zone contains invalid or missing data.");
}
catch (SecurityException)
{
    Console.WriteLine("The application lacks permission to read time zone information from the registry.");
}
catch (OutOfMemoryException)
{
    Console.WriteLine("Not enough memory is available to load information on the Eastern Standard Time zone.");
}
// If we weren't passing FindSystemTimeZoneById a literal string, we also
// would handle an ArgumentNullException.

Dim timeNow As Date = Date.Now
Try
    Dim easternZone As TimeZoneInfo = TimeZoneInfo.FindSystemTimeZoneById("Eastern Standard Time")
    Dim easternTimeNow As Date = TimeZoneInfo.ConvertTime(timeNow, TimeZoneInfo.Local, easternZone)
    Console.WriteLine("{0} {1} corresponds to {2} {3}.", _
                      timeNow, _
                      IIf(TimeZoneInfo.Local.IsDaylightSavingTime(timeNow), _
                          TimeZoneInfo.Local.DaylightName, TimeZoneInfo.Local.StandardName), _
                      easternTimeNow, _
                      IIf(easternZone.IsDaylightSavingTime(easternTimeNow), _
                          easternZone.DaylightName, easternZone.StandardName))
    ' Handle exception
    '
    ' As an alternative to simply displaying an error message, an alternate Eastern
    ' Standard Time TimeZoneInfo object could be instantiated here either by restoring
    ' it from a serialized string or by providing the necessary data to the
    ' CreateCustomTimeZone method.
Catch e As TimeZoneNotFoundException
    Console.WriteLine("The Eastern Standard Time Zone cannot be found on the local system.")
Catch e As InvalidTimeZoneException
    Console.WriteLine("The Eastern Standard Time Zone contains invalid or missing data.")
Catch e As SecurityException
    Console.WriteLine("The application lacks permission to read time zone information from the registry.")
Catch e As OutOfMemoryException
    Console.WriteLine("Not enough memory is available to load information on the Eastern Standard Time zone.")
    ' If we weren't passing FindSystemTimeZoneById a literal string, we also 
    ' would handle an ArgumentNullException.
End Try

TimeZoneInfo.FindSystemTimeZoneById メソッドの唯一のパラメーターは、取得するタイムゾーンの識別子です。これは、オブジェクトの TimeZoneInfo.Id プロパティに対応します。タイムゾーン ID は、タイムゾーンを一意に識別するキーフィールドです。ほとんどのキーは比較的短いですが、タイムゾーン ID はいくぶん長めです。ほとんどの場合、ID の値は、タイムゾーンの標準時刻の名前を表すために使用される StandardName オブジェクトの TimeZoneInfo プロパティに対応します。ただし、例外もあります。有効な識別子を確実に指定する最良の方法は、システムで使用できるタイムゾーンを列挙し、対応するタイムゾーン識別子を記録しておくことです。この具体例については、「 How to: Enumerate time zones present on a computer」を参照してください。「ローカルシステムで定義されているタイムゾーンの検索」記事には、選択したタイムゾーン識別子の一覧も含まれています。

タイムゾーンが見つかると、メソッドは TimeZoneInfo オブジェクトを返します。タイムゾーンが見つからない場合、メソッドから TimeZoneNotFoundExceptionがスローされます。タイムゾーンが見つかっても、そのデータが破損しているか不完全な場合には、メソッドから InvalidTimeZoneExceptionがスローされます。

アプリケーションが依存するタイムゾーンが必ず存在していなければならない場合は、最初に FindSystemTimeZoneById メソッドを呼び出して、レジストリからタイムゾーンの情報を取得する必要があります。メソッドの呼び出しが失敗した場合は、例外ハンドラーで、タイムゾーンの新しいインスタンスを作成するか、シリアル化された TimeZoneInfo オブジェクトを逆シリアル化してインスタンスを作成し直す必要があります。例については、「方法: 埋め込みリソースからタイムゾーンを復元する」をご覧ください。

次の方法で共有

方法: TimeZoneInfo オブジェクトを取得する

例

関連項目

その他のリソース