DateTimeOffset.Year Property

Gets the year component of the date represented by the current DateTimeOffset object.

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

public int Year { get; }

Property Value

Type: System.Int32
The year component of the current DateTimeOffset object, expressed as an integer value between 0 and 9999.

The Year property is not affected by the value of the Offset property.

You can also create a string representation of a DateTimeOffset object's year component by calling the ToString method with the "y", "yy", or "yyyy" custom format specifiers.

The following example displays the year component of a DateTimeOffset value in four different ways:

  • By retrieving the value of the Year property.

  • By calling the ToString(String) method with the "y" format specifier.

  • By calling the ToString(String) method with the "yy" format specifier.

  • By calling the ToString(String) method with the "yyyy" format specifier.

DateTimeOffset theTime = new DateTimeOffset(2008, 2, 17, 9, 0, 0, 
                             DateTimeOffset.Now.Offset);
Console.WriteLine("The year component of {0} is {1}.", 
                  theTime, theTime.Year);

Console.WriteLine("The year component of {0} is{1}.", 
                  theTime, theTime.ToString(" y"));

Console.WriteLine("The year component of {0} is {1}.", 
                  theTime, theTime.ToString("yy"));

Console.WriteLine("The year component of {0} is {1}.", 
                  theTime, theTime.ToString("yyyy"));
// The example produces the following output: 
//    The year component of 2/17/2008 9:00:00 AM -07:00 is 2008. 
//    The year component of 2/17/2008 9:00:00 AM -07:00 is 8. 
//    The year component of 2/17/2008 9:00:00 AM -07:00 is 08. 
//    The year component of 2/17/2008 9:00:00 AM -07:00 is 2008.

.NET Framework

Supported in: 4.6, 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

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft