DateTime.ToUniversalTime メソッド

現在のローカル時刻を世界協定時刻 (UTC) に変換します。

Public Function ToUniversalTime() As DateTime
[C#]
public DateTime ToUniversalTime();
[C++]
public: DateTime ToUniversalTime();
[JScript]
public function ToUniversalTime() : DateTime;

戻り値

現在のローカル時刻と等価の UTC 時刻 DateTime 。

または

現在のローカル時刻が大きすぎて DateTime として表すことができない場合は MaxValue 。

または

現在のローカル時刻が小さすぎて DateTime として表すことができない場合は MinValue 。

解説

UTC 時刻は、ローカル時刻から UTC オフセットを減算した値です。UTC オフセットの詳細については、 TimeZone.GetUtcOffset のトピックを参照してください。

このメソッドは、現在の DateTime が UTC 時刻ではなくローカル時刻値を保持していることを前提にしています。このため、このメソッドを実行するたびに、現在の DateTime がローカル時刻を保持しているかどうかに関係なく、現在のメソッドが DateTime に対して必要な変更を実行して UTC 時刻を派生させます。

このメソッドは、計算するときに常にローカル タイム ゾーンを使用します。

使用例

[Visual Basic, C#, C++] ToUniversalTime のサンプルを次に示します。

 
System.Console.WriteLine("Enter a date and time.")
Dim strDateTime As String
strDateTime = System.Console.ReadLine()

Dim localDateTime As System.DateTime
Try
   localDateTime = System.DateTime.Parse(strDateTime)
Catch exp As System.FormatException
   System.Console.WriteLine("Invalid format.")
End Try

Dim univDateTime As System.DateTime
univDateTime = localDateTime.ToUniversalTime()

System.Console.WriteLine("{0} local time is {1} universal time.", _
                           localDateTime, _
                           univDateTime)

System.Console.WriteLine("Enter a date and time in universal time.")
strDateTime = System.Console.ReadLine()

Try
   univDateTime = System.DateTime.Parse(strDateTime)
Catch exp As System.FormatException
   System.Console.WriteLine("Invalid format.")
End Try

localDateTime = univDateTime.ToLocalTime()

System.Console.WriteLine("{0} universal time is {1} local time.", _
                           univDateTime, _
                           localDateTime)

[C#] 
System.Console.WriteLine("Enter a date and time.");
string strDateTime = System.Console.ReadLine();

System.DateTime localDateTime;
try {
    localDateTime = System.DateTime.Parse(strDateTime);
}
catch (System.FormatException) {
    System.Console.WriteLine("Invalid format.");
    return;
}

System.DateTime univDateTime = localDateTime.ToUniversalTime();

System.Console.WriteLine("{0} local time is {1} universal time.",
                         localDateTime,
                         univDateTime); 

System.Console.WriteLine("Enter a date and time in universal time.");
strDateTime = System.Console.ReadLine();

try {
    univDateTime = System.DateTime.Parse(strDateTime);
}
catch (System.FormatException) {
    System.Console.WriteLine("Invalid format.");
    return;
}

localDateTime = univDateTime.ToLocalTime();

System.Console.WriteLine("{0} universal time is {1} local time.",
                         univDateTime,
                         localDateTime); 

[C++] 
System::Console::WriteLine(S"Enter a date and time.");
String* strDateTime = System::Console::ReadLine();

System::DateTime localDateTime;
try {
   localDateTime = System::DateTime::Parse(strDateTime);
} catch (System::FormatException*) {
   System::Console::WriteLine(S"Invalid format.");
   return;
}

System::DateTime univDateTime = localDateTime.ToUniversalTime();

System::Console::WriteLine(S"{0} local time is {1} universal time.", __box(localDateTime), __box(univDateTime));

System::Console::WriteLine(S"Enter a date and time in universal time.");
strDateTime = System::Console::ReadLine();

try {
   univDateTime = System::DateTime::Parse(strDateTime);
} catch (System::FormatException*) {
   System::Console::WriteLine(S"Invalid format.");
   return;
}

localDateTime = univDateTime.ToLocalTime();

System::Console::WriteLine(S"{0} universal time is {1} local time.", __box(univDateTime), __box(localDateTime));

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard

参照

DateTime 構造体 | DateTime メンバ | System 名前空間 | ToLocalTime