DateTimeOffset.Year Property

Definition

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

public:
 property int Year { int get(); };
public int Year { get; }
member this.Year : int
Public ReadOnly Property Year As Integer

Property Value

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

Examples

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.
let theTime = DateTimeOffset(2008, 2, 17, 9, 0, 0, DateTimeOffset.Now.Offset)
printfn $"The year component of {theTime} is {theTime.Year}."

printfn $"""The year component of {theTime} is{theTime.ToString " y"}."""

printfn $"The year component of {theTime} is {theTime:yy}."

printfn $"The year component of {theTime} is {theTime: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.
Dim theTime As New DateTimeOffset(#2/17/2008 9:00AM#, _
                                  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.

Remarks

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.

Applies to