Поделиться через


DateTimeOffset.UtcNow Property

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Gets a DateTimeOffset object whose date and time are set to the current Coordinated Universal Time (UTC) date and time and whose offset is TimeSpan.Zero.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Shared ReadOnly Property UtcNow As DateTimeOffset
public static DateTimeOffset UtcNow { get; }

Property Value

Type: System.DateTimeOffset
An object whose date and time is the current Coordinated Universal Time (UTC) and whose offset is TimeSpan.Zero.

Remarks

The UtcNow property computes the current Universal Coordinated Time (UTC) based on the local system's clock time and an offset defined by the local system's time zone.

The precision of the current UTC time's millisecond component depends on the resolution of the system clock. On Windows NT 3.5 and later, and Windows Vista operating systems, the clock's resolution is approximately 10-15 milliseconds.

Examples

The following example illustrates the relationship between Coordinated Universal Time (UTC) and local time.

Dim localTime As DateTimeOffset = DateTimeOffset.Now
Dim utcTime As DateTimeOffset = DateTimeOffset.UtcNow

outputBlock.Text &= String.Format("Local Time:          {0}", localTime.ToString("T")) & vbCrLf
outputBlock.Text &= String.Format("Difference from UTC: {0}", localTime.Offset.ToString()) & vbCrLf
outputBlock.Text &= String.Format("UTC:                 {0}", utcTime.ToString("T")) & vbCrLf
' If run on a particular date at 1:19 PM, the example produces
' the following output:
'    Local Time:          1:19:43 PM
'    Difference from UTC: -07:00:00
'    UTC:                 8:19:43 PM      
DateTimeOffset localTime = DateTimeOffset.Now;
DateTimeOffset utcTime = DateTimeOffset.UtcNow;

outputBlock.Text += String.Format("Local Time:          {0}", localTime.ToString("T")) + "\n";
outputBlock.Text += String.Format("Difference from UTC: {0}", localTime.Offset.ToString()) + "\n";
outputBlock.Text += String.Format("UTC:                 {0}", utcTime.ToString("T")) + "\n";
// If run on a particular date at 1:19 PM, the example produces
// the following output:
//    Local Time:          1:19:43 PM
//    Difference from UTC: -07:00:00
//    UTC:                 8:19:43 PM      

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.