HebrewCalendar::GetDayOfYear Method (DateTime)
Returns the day of the year in the specified DateTime.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- time
-
Type:
System::DateTime
The DateTime to read.
Return Value
Type: System::Int32An integer from 1 to 385 that represents the day of the year in the specified DateTime.
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | time is earlier than September 17, 1583 in the Gregorian calendar, or greater than MaxSupportedDateTime. |
The day of the year is defined as the number of days from the first day of the year. For example, GetDayOfYear for the first day of the first month returns 1, and GetDayOfYear for the last day of the last month returns the total number of days in that year, which is the same value returned by GetDaysInYear.
This implementation of the HebrewCalendar class recognizes only the Hebrew years 5343 to 5999 (1583 to 2239 in the Gregorian calendar).
The following code example displays the values of several components of a DateTime in terms of the Hebrew calendar.
using namespace System; using namespace System::Globalization; void DisplayValues( Calendar^ myCal, DateTime myDT ) { Console::WriteLine( " Era: {0}", myCal->GetEra( myDT ) ); Console::WriteLine( " Year: {0}", myCal->GetYear( myDT ) ); Console::WriteLine( " Month: {0}", myCal->GetMonth( myDT ) ); Console::WriteLine( " DayOfYear: {0}", myCal->GetDayOfYear( myDT ) ); Console::WriteLine( " DayOfMonth: {0}", myCal->GetDayOfMonth( myDT ) ); Console::WriteLine( " DayOfWeek: {0}", myCal->GetDayOfWeek( myDT ) ); Console::WriteLine(); } int main() { // Sets a DateTime to April 3, 2002 of the Gregorian calendar. DateTime myDT = DateTime(2002,4,3,gcnew GregorianCalendar); // Creates an instance of the HebrewCalendar. HebrewCalendar^ myCal = gcnew HebrewCalendar; // Displays the values of the DateTime. Console::WriteLine( "April 3, 2002 of the Gregorian calendar equals the following in the Hebrew calendar:" ); DisplayValues( myCal, myDT ); // Adds two years and ten months. myDT = myCal->AddYears( myDT, 2 ); myDT = myCal->AddMonths( myDT, 10 ); // Displays the values of the DateTime. Console::WriteLine( "After adding two years and ten months:" ); DisplayValues( myCal, myDT ); } /* This code produces the following output. April 3, 2002 of the Gregorian calendar equals the following in the Hebrew calendar: Era: 1 Year: 5762 Month: 7 DayOfYear: 198 DayOfMonth: 21 DayOfWeek: Wednesday After adding two years and ten months: Era: 1 Year: 5765 Month: 5 DayOfYear: 138 DayOfMonth: 21 DayOfWeek: Monday */
Available since 10
.NET Framework
Available since 1.1
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0