Calendar.ToFourDigitYear Method

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

Converts the specified year to a four-digit year by using the TwoDigitYearMax property to determine the appropriate century.

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

Syntax

'Declaration
Public Overridable Function ToFourDigitYear ( _
    year As Integer _
) As Integer
public virtual int ToFourDigitYear(
    int year
)

Parameters

  • year
    Type: System.Int32
    A two-digit or four-digit integer that represents the year to convert.

Return Value

Type: System.Int32
An integer that contains the four-digit representation of year.

Exceptions

Exception Condition
ArgumentOutOfRangeException

year is outside the range supported by the calendar.

Remarks

TwoDigitYearMax is the last year in the 100-year range that can be represented by a two-digit year. The century is determined by finding the sole occurrence of the two-digit year within that 100-year range. For example, if TwoDigitYearMax is set to 2029, the 100-year range is from 1930 to 2029. Therefore, a 2-digit value of 30 is interpreted as 1930, while a 2-digit value of 29 is interpreted as 2029.

If year is greater than or equal to 100, the value of year is returned unchanged.

ToFourDigitYear supports either a two-digit year or a four-digit year. Passing a two-digit year value (less than 100) causes the method to convert the value to a four-digit value according to the TwoDigitYearMax value representing the appropriate century. If the application supplies a four-digit year value that is within the supported calendar range to ToFourDigitYear, the method returns the actual input value. If the application supplies a four-digit value that is outside the supported calendar range, or if it supplies a negative value, the method throws an exception.

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.