.NET Framework Class Library
DateTimeOffset Structure

Represents a point in time, typically expressed as a date and time of day, relative to Coordinated Universal Time (UTC).

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)
Syntax
<[%$TOPIC/bb341783_en-us_VS_110_1_0_0_0_0%]> _
Public Structure DateTimeOffset _
	Implements [%$TOPIC/bb341783_en-us_VS_110_1_0_0_0_1%], [%$TOPIC/bb341783_en-us_VS_110_1_0_0_0_2%], [%$TOPIC/bb341783_en-us_VS_110_1_0_0_0_3%], [%$TOPIC/bb341783_en-us_VS_110_1_0_0_0_4%],  _
	[%$TOPIC/bb341783_en-us_VS_110_1_0_0_0_5%](Of DateTimeOffset), [%$TOPIC/bb341783_en-us_VS_110_1_0_0_0_6%](Of DateTimeOffset)
[[%$TOPIC/bb341783_en-us_VS_110_1_0_1_0_0%]]
public struct DateTimeOffset : [%$TOPIC/bb341783_en-us_VS_110_1_0_1_0_1%], 
	[%$TOPIC/bb341783_en-us_VS_110_1_0_1_0_2%], [%$TOPIC/bb341783_en-us_VS_110_1_0_1_0_3%], [%$TOPIC/bb341783_en-us_VS_110_1_0_1_0_4%], [%$TOPIC/bb341783_en-us_VS_110_1_0_1_0_5%]<DateTimeOffset>, 
	[%$TOPIC/bb341783_en-us_VS_110_1_0_1_0_6%]<DateTimeOffset>
[[%$TOPIC/bb341783_en-us_VS_110_1_0_2_0_0%]]
public value class DateTimeOffset : [%$TOPIC/bb341783_en-us_VS_110_1_0_2_0_1%], 
	[%$TOPIC/bb341783_en-us_VS_110_1_0_2_0_2%], [%$TOPIC/bb341783_en-us_VS_110_1_0_2_0_3%], [%$TOPIC/bb341783_en-us_VS_110_1_0_2_0_4%], [%$TOPIC/bb341783_en-us_VS_110_1_0_2_0_5%]<DateTimeOffset>, 
	[%$TOPIC/bb341783_en-us_VS_110_1_0_2_0_6%]<DateTimeOffset>
[<[%$TOPIC/bb341783_en-us_VS_110_1_0_3_0_0%]>]
[<[%$TOPIC/bb341783_en-us_VS_110_1_0_3_0_1%]>]
type DateTimeOffset =  
    struct 
        interface [%$TOPIC/bb341783_en-us_VS_110_1_0_3_0_2%] 
        interface [%$TOPIC/bb341783_en-us_VS_110_1_0_3_0_3%] 
        interface [%$TOPIC/bb341783_en-us_VS_110_1_0_3_0_4%] 
        interface [%$TOPIC/bb341783_en-us_VS_110_1_0_3_0_5%] 
        interface [%$TOPIC/bb341783_en-us_VS_110_1_0_3_0_6%]<DateTimeOffset>
        interface [%$TOPIC/bb341783_en-us_VS_110_1_0_3_0_7%]<DateTimeOffset>
    end

The DateTimeOffset type exposes the following members.

Constructors
  NameDescription
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps DateTimeOffset(DateTime)Initializes a new instance of the DateTimeOffset structure using the specified DateTime value.
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps DateTimeOffset(DateTime, TimeSpan)Initializes a new instance of the DateTimeOffset structure using the specified DateTime value and offset.
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps DateTimeOffset(Int64, TimeSpan)Initializes a new instance of the DateTimeOffset structure using the specified number of ticks and offset.
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)Initializes a new instance of the DateTimeOffset structure using the specified year, month, day, hour, minute, second, and offset.
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)Initializes a new instance of the DateTimeOffset structure using the specified year, month, day, hour, minute, second, millisecond, and offset.
Public method DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)Initializes a new instance of the DateTimeOffset structure using the specified year, month, day, hour, minute, second, millisecond, and offset of a specified calendar.
Top
Properties
  NameDescription
Public property Supported by Portable Class Library Supported in .NET for Windows Store apps DateGets a DateTime value that represents the date component of the current DateTimeOffset object.
Public property Supported by Portable Class Library Supported in .NET for Windows Store apps DateTimeGets a DateTime value that represents the date and time of the current DateTimeOffset object.
Public property Supported by Portable Class Library Supported in .NET for Windows Store apps DayGets the day of the month represented by the current DateTimeOffset object.
Public property Supported by Portable Class Library Supported in .NET for Windows Store apps DayOfWeekGets the day of the week represented by the current DateTimeOffset object.
Public property Supported by Portable Class Library Supported in .NET for Windows Store apps DayOfYearGets the day of the year represented by the current DateTimeOffset object.
Public property Supported by Portable Class Library Supported in .NET for Windows Store apps HourGets the hour component of the time represented by the current DateTimeOffset object.
Public property Supported by Portable Class Library Supported in .NET for Windows Store apps LocalDateTimeGets a DateTime value that represents the local date and time of the current DateTimeOffset object.
Public property Supported by Portable Class Library Supported in .NET for Windows Store apps MillisecondGets the millisecond component of the time represented by the current DateTimeOffset object.
Public property Supported by Portable Class Library Supported in .NET for Windows Store apps MinuteGets the minute component of the time represented by the current DateTimeOffset object.
Public property Supported by Portable Class Library Supported in .NET for Windows Store apps MonthGets the month component of the date represented by the current DateTimeOffset object.
Public property Static member Supported by Portable Class Library Supported in .NET for Windows Store apps NowGets a DateTimeOffset object that is set to the current date and time on the current computer, with the offset set to the local time's offset from Coordinated Universal Time (UTC).
Public property Supported by Portable Class Library Supported in .NET for Windows Store apps OffsetGets the time's offset from Coordinated Universal Time (UTC).
Public property Supported by Portable Class Library Supported in .NET for Windows Store apps SecondGets the second component of the clock time represented by the current DateTimeOffset object.
Public property Supported by Portable Class Library Supported in .NET for Windows Store apps TicksGets the number of ticks that represents the date and time of the current DateTimeOffset object in clock time.
Public property Supported by Portable Class Library Supported in .NET for Windows Store apps TimeOfDayGets the time of day for the current DateTimeOffset object.
Public property Supported by Portable Class Library Supported in .NET for Windows Store apps UtcDateTimeGets a DateTime value that represents the Coordinated Universal Time (UTC) date and time of the current DateTimeOffset object.
Public property Static member Supported by Portable Class Library Supported in .NET for Windows Store apps UtcNowGets a DateTimeOffset object whose date and time are set to the current Coordinated Universal Time (UTC) date and time and whose offset is TimeSpanZero.
Public property Supported by Portable Class Library Supported in .NET for Windows Store apps UtcTicksGets the number of ticks that represents the date and time of the current DateTimeOffset object in Coordinated Universal Time (UTC).
Public property Supported by Portable Class Library Supported in .NET for Windows Store apps YearGets the year component of the date represented by the current DateTimeOffset object.
Top
Methods
  NameDescription
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps AddAdds a specified time interval to a DateTimeOffset object.
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps AddDaysAdds a specified number of whole and fractional days to the current DateTimeOffset object.
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps AddHoursAdds a specified number of whole and fractional hours to the current DateTimeOffset object.
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps AddMillisecondsAdds a specified number of milliseconds to the current DateTimeOffset object.
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps AddMinutesAdds a specified number of whole and fractional minutes to the current DateTimeOffset object.
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps AddMonthsAdds a specified number of months to the current DateTimeOffset object.
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps AddSecondsAdds a specified number of whole and fractional seconds to the current DateTimeOffset object.
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps AddTicksAdds a specified number of ticks to the current DateTimeOffset object.
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps AddYearsAdds a specified number of years to the DateTimeOffset object.
Public method Static member Supported by Portable Class Library Supported in .NET for Windows Store apps CompareCompares two DateTimeOffset objects and indicates whether the first is earlier than the second, equal to the second, or later than the second.
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps CompareToCompares the current DateTimeOffset object to a specified DateTimeOffset object and indicates whether the current object is earlier than, the same as, or later than the second DateTimeOffset object.
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps Equals(DateTimeOffset)Determines whether the current DateTimeOffset object represents the same point in time as a specified DateTimeOffset object.
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps Equals(Object)Determines whether a DateTimeOffset object represents the same point in time as a specified object. (Overrides ValueTypeEquals(Object).)
Public method Static member Supported by Portable Class Library Supported in .NET for Windows Store apps Equals(DateTimeOffset, DateTimeOffset)Determines whether two specified DateTimeOffset objects represent the same point in time.
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps EqualsExactDetermines whether the current DateTimeOffset object represents the same time and has the same offset as a specified DateTimeOffset object.
Public method Static member Supported by Portable Class Library Supported in .NET for Windows Store apps FromFileTimeConverts the specified Windows file time to an equivalent local time.
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps GetHashCodeReturns the hash code for the current DateTimeOffset object. (Overrides ValueTypeGetHashCode.)
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps GetTypeGets the Type of the current instance. (Inherited from Object.)
Public method Static member Supported by Portable Class Library Supported in .NET for Windows Store apps Parse(String)Converts the specified string representation of a date, time, and offset to its DateTimeOffset equivalent.
Public method Static member Supported by Portable Class Library Supported in .NET for Windows Store apps Parse(String, IFormatProvider)Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified culture-specific format information.
Public method Static member Supported by Portable Class Library Supported in .NET for Windows Store apps Parse(String, IFormatProvider, DateTimeStyles)Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified culture-specific format information and formatting style.
Public method Static member Supported by Portable Class Library Supported in .NET for Windows Store apps ParseExact(String, String, IFormatProvider)Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified format and culture-specific format information. The format of the string representation must match the specified format exactly.
Public method Static member Supported by Portable Class Library Supported in .NET for Windows Store apps ParseExact(String, String, IFormatProvider, DateTimeStyles)Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified format, culture-specific format information, and style. The format of the string representation must match the specified format exactly.
Public method Static member Supported by Portable Class Library Supported in .NET for Windows Store apps ParseExact(String, String, IFormatProvider, DateTimeStyles)Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified formats, culture-specific format information, and style. The format of the string representation must match one of the specified formats exactly.
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps Subtract(DateTimeOffset)Subtracts a DateTimeOffset value that represents a specific date and time from the current DateTimeOffset object.
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps Subtract(TimeSpan)Subtracts a specified time interval from the current DateTimeOffset object.
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps ToFileTimeConverts the value of the current DateTimeOffset object to a Windows file time.
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps ToLocalTimeConverts the current DateTimeOffset object to a DateTimeOffset object that represents the local time.
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps ToOffsetConverts the value of the current DateTimeOffset object to the date and time specified by an offset value.
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps ToStringConverts the value of the current DateTimeOffset object to its equivalent string representation. (Overrides ValueTypeToString.)
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps ToString(IFormatProvider)Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified culture-specific formatting information.
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps ToString(String)Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified format.
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps ToString(String, IFormatProvider)Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified format and culture-specific format information.
Public method Supported by Portable Class Library Supported in .NET for Windows Store apps ToUniversalTimeConverts the current DateTimeOffset object to a DateTimeOffset value that represents the Coordinated Universal Time (UTC).
Public method Static member Supported by Portable Class Library Supported in .NET for Windows Store apps TryParse(String, DateTimeOffset)Tries to converts a specified string representation of a date and time to its DateTimeOffset equivalent, and returns a value that indicates whether the conversion succeeded.
Public method Static member Supported by Portable Class Library Supported in .NET for Windows Store apps TryParse(String, IFormatProvider, DateTimeStyles, DateTimeOffset)Tries to convert a specified string representation of a date and time to its DateTimeOffset equivalent, and returns a value that indicates whether the conversion succeeded.
Public method Static member Supported by Portable Class Library Supported in .NET for Windows Store apps TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTimeOffset)Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified format, culture-specific format information, and style. The format of the string representation must match the specified format exactly.
Public method Static member Supported by Portable Class Library Supported in .NET for Windows Store apps TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTimeOffset)Converts the specified string representation of a date and time to its DateTimeOffset equivalent using the specified array of formats, culture-specific format information, and style. The format of the string representation must match one of the specified formats exactly.
Top
Operators
  NameDescription
Public operator Static member Supported by Portable Class Library Supported in .NET for Windows Store apps AdditionAdds a specified time interval to a DateTimeOffset object that has a specified date and time, and yields a DateTimeOffset object that has new a date and time.
Public operator Static member Supported by Portable Class Library Supported in .NET for Windows Store apps EqualityDetermines whether two specified DateTimeOffset objects represent the same point in time.
Public operator Static member Supported by Portable Class Library Supported in .NET for Windows Store apps GreaterThanDetermines whether one specified DateTimeOffset object is greater than (or later than) a second specified DateTimeOffset object.
Public operator Static member Supported by Portable Class Library Supported in .NET for Windows Store apps GreaterThanOrEqualDetermines whether one specified DateTimeOffset object is greater than or equal to a second specified DateTimeOffset object.
Public operator Static member Supported by Portable Class Library Supported in .NET for Windows Store apps (DateTime to DateTimeOffset)Defines an implicit conversion of a DateTime object to a DateTimeOffset object.
Public operator Static member Supported by Portable Class Library Supported in .NET for Windows Store apps InequalityDetermines whether two specified DateTimeOffset objects refer to different points in time.
Public operator Static member Supported by Portable Class Library Supported in .NET for Windows Store apps LessThanDetermines whether one specified DateTimeOffset object is less than a second specified DateTimeOffset object.
Public operator Static member Supported by Portable Class Library Supported in .NET for Windows Store apps LessThanOrEqualDetermines whether one specified DateTimeOffset object is less than a second specified DateTimeOffset object.
Public operator Static member Supported by Portable Class Library Supported in .NET for Windows Store apps Subtraction(DateTimeOffset, DateTimeOffset)Subtracts one DateTimeOffset object from another and yields a time interval.
Public operator Static member Supported by Portable Class Library Supported in .NET for Windows Store apps Subtraction(DateTimeOffset, TimeSpan)Subtracts a specified time interval from a specified date and time, and yields a new date and time.
Top
Fields
  NameDescription
Public field Static member Supported by Portable Class Library Supported in .NET for Windows Store apps MaxValueRepresents the greatest possible value of DateTimeOffset. This field is read-only.
Public field Static member Supported by Portable Class Library Supported in .NET for Windows Store apps MinValueRepresents the earliest possible DateTimeOffset value. This field is read-only.
Top
Explicit Interface Implementations
  NameDescription
Explicit interface implemetation Private method Supported by Portable Class Library Supported in .NET for Windows Store apps IComparableCompareToInfrastructure. Compares the value of the current DateTimeOffset object with another object of the same type.
Explicit interface implemetation Private method IDeserializationCallbackOnDeserializationInfrastructure. Runs when the deserialization of an object has been completed.
Explicit interface implemetation Private method ISerializableGetObjectDataInfrastructure. Populates a SerializationInfo object with the data required to serialize the current DateTimeOffset object.
Top
Remarks

The DateTimeOffset structure includes a DateTime value, together with an Offset property that defines the difference between the current DateTimeOffset instance's date and time and Coordinated Universal Time (UTC). Because it exactly defines a date and time relative to UTC, the DateTimeOffset structure does not include a Kind member, as the DateTime structure does. It represents dates and times with values whose UTC ranges from 12:00:00 midnight, January 1, 0001 Anno Domini (Common Era), to 11:59:59 P.M., December 31, 9999 A.D. (C.E.).

The time component of a DateTimeOffset value is measured in 100-nanosecond units called ticks, and a particular date is the number of ticks since 12:00 midnight, January 1, 0001 A.D. (C.E.) in the GregorianCalendar calendar. A DateTimeOffset value is always expressed in the context of an explicit or default calendar. Ticks that are attributable to leap seconds are not included in the total number of ticks.

NoteNote

   If you are working with a ticks value that you want to convert to some other time interval, such as minutes or seconds, you should use the TimeSpanTicksPerDay, TimeSpanTicksPerHour, TimeSpanTicksPerMinute, TimeSpanTicksPerSecond, or TimeSpanTicksPerMillisecond constant to perform the conversion. For example, to add the number of seconds represented by a specified number of ticks to the Second component of a DateTimeOffset value, you can use the expression dateValue.Second + nTicks/Timespan.TicksPerSecond.

Although a DateTimeOffset value includes an offset, it is not a fully time zone-aware data structure. While an offset from UTC is one characteristic of a time zone, it does not unambiguously identify a time zone. Not only do multiple time zones share the same offset from UTC, but the offset of a single time zone changes if it observes daylight saving time. This means that, as soon as a DateTimeOffset value is disassociated from its time zone, it can no longer be unambiguously linked back to its original time zone.

Because DateTimeOffset is a structure, a DateTimeOffset object that has been declared but not otherwise initialized contains the default values for each of its member fields. This means that its DateTime property is set to DateTimeOffsetMinValue and its Offset property is set to TimeSpanZero.

You can create a new DateTimeOffset value by calling any of the overloads of its constructor, which are similar to the overloaded constructors for the DateTime structure. You can also create a new DateTimeOffset value by assigning it a DateTime value. This is an implicit conversion; it does not require a casting operator (in C#) or call to a conversion method (in Visual Basic). You can also initialize a DateTimeOffset value from the string representation of a date and time by calling a number of static string parsing methods, which include Parse, ParseExact, TryParse, and TryParseExact.

The members of the DateTimeOffset structure provide functionality in the following areas:

  • Date and time arithmetic.

    You can add or subtract either dates or time intervals from a particular DateTimeOffset value. Arithmetic operations with DateTimeOffset values, unlike those with DateTime values, adjust for differences in time offsets when returning a result. For example, the following code uses DateTime variables to subtract the current local time from the current UTC time. The code then uses DateTimeOffset variables to perform the same operation. The subtraction with DateTime values returns the local time zone's difference from UTC, while the subtraction with DateTimeOffset values returns TimeSpanZero.

    Module DateArithmetic
       Public Sub Main()
          Dim date1, date2 As Date 
          Dim dateOffset1, dateOffset2 As DateTimeOffset
          Dim difference As TimeSpan
    
          ' Find difference between Date.Now and Date.UtcNow
          date1 = Date.Now
          date2 = Date.UtcNow
          difference = date1 - date2
          Console.WriteLine("{0} - {1} = {2}", date1, date2, difference)
    
          ' Find difference between Now and UtcNow using DateTimeOffset
          dateOffset1 = date.Now
          dateOffset2 = date.UtcNow
          difference = dateOffset1 - dateOffset2
          Console.WriteLine("{0} - {1} = {2}", _
                            dateOffset1, dateOffset2, difference)
          ' If run in the Pacific Standard time zone on 4/2/2007, the example 
          ' displays the following output to the console: 
          '    4/2/2007 7:23:57 PM - 4/3/2007 2:23:57 AM = -07:00:00 
          '    4/2/2007 7:23:57 PM -07:00 - 4/3/2007 2:23:57 AM +00:00 = 00:00:00                         
       End Sub 
    End Module
    using System;
    
    public class DateArithmetic
    {
       public static void Main()
       {
          DateTime date1, date2;
          DateTimeOffset dateOffset1, dateOffset2;
          TimeSpan difference;
    
          // Find difference between Date.Now and Date.UtcNow
          date1 = DateTime.Now;
          date2 = DateTime.UtcNow;
          difference = date1 - date2;
          Console.WriteLine("{0} - {1} = {2}", date1, date2, difference);
    
          // Find difference between Now and UtcNow using DateTimeOffset
          dateOffset1 = DateTimeOffset.Now;
          dateOffset2 = DateTimeOffset.UtcNow;
          difference = dateOffset1 - dateOffset2;
          Console.WriteLine("{0} - {1} = {2}", 
                            dateOffset1, dateOffset2, difference);
          // If run in the Pacific Standard time zone on 4/2/2007, the example 
          // displays the following output to the console: 
          //    4/2/2007 7:23:57 PM - 4/3/2007 2:23:57 AM = -07:00:00 
          //    4/2/2007 7:23:57 PM -07:00 - 4/3/2007 2:23:57 AM +00:00 = 00:00:00                        
       }
    }
  • Type conversion operations.

    You can convert DateTimeOffset values to DateTime values and vice versa.

  • Time manipulation and extraction operations.

    You can extract either the date or the time of a DateTimeOffset value. You can also retrieve the value of a particular DateTimeOffset component, such as its year or its month.

  • Date and time conversion.

    You can convert any DateTimeOffset value to another DateTimeOffset value that represents the same point in time in another time zone. However, a time zone's adjustment rules are applied only in the case of the ToLocalTime method, which converts a DateTimeOffset value to the date and time in the local system zone.

  • Date and time comparison.

    You can determine whether any particular DateTimeOffset value is earlier than, the same as, or later than another DateTimeOffset value. Before the comparison is performed, all values are converted to UTC.

Version Information

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5 SP1, 3.0 SP1, 2.0 SP1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone 8, Silverlight 8.1
Platforms

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.