ToFourDigitYear Method

Calendar.ToFourDigitYear Method

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)

public virtual int ToFourDigitYear (
	int year
)
public int ToFourDigitYear (
	int year
)
public function ToFourDigitYear (
	year : int
) : int
Not applicable.

Parameters

year

A two-digit or four-digit integer that represents the year to convert.

Return Value

An integer that contains the four-digit representation of year.

Exception typeCondition

ArgumentOutOfRangeException

year is outside the range supported by the calendar.

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.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

XNA Framework

Supported in: 1.0

Community Additions

ADD
Show:
© 2016 Microsoft