DateTime.DayOfYear Свойство

Определение

Возвращает день года, представленный этим экземпляром.

C#
public int DayOfYear { get; }

Значение свойства

Компонент, представляющий день года, выраженный как значение от 1 до 366.

Примеры

В следующем примере отображается день года 31 декабря для 2010–2020 годов в григорианском календаре. Обратите внимание, что в примере показано, что 31 декабря является 366-м днем года в високосных годах.

C#
using System;

public class Example
{
   public static void Main()
   {
      DateTime dec31 = new DateTime(2010, 12, 31);
      for (int ctr = 0; ctr <= 10; ctr++) {
         DateTime dateToDisplay = dec31.AddYears(ctr);
         Console.WriteLine("{0:d}: day {1} of {2} {3}", dateToDisplay,
                           dateToDisplay.DayOfYear,
                           dateToDisplay.Year,
                           DateTime.IsLeapYear(dateToDisplay.Year) ?
                                               "(Leap Year)" : "");
      }
   }
}
// The example displays the following output:
//       12/31/2010: day 365 of 2010
//       12/31/2011: day 365 of 2011
//       12/31/2012: day 366 of 2012 (Leap Year)
//       12/31/2013: day 365 of 2013
//       12/31/2014: day 365 of 2014
//       12/31/2015: day 365 of 2015
//       12/31/2016: day 366 of 2016 (Leap Year)
//       12/31/2017: day 365 of 2017
//       12/31/2018: day 365 of 2018
//       12/31/2019: day 365 of 2019
//       12/31/2020: day 366 of 2020 (Leap Year)

Комментарии

Свойство DayOfYear учитывает високосные годы при расчете дня года. Значение свойства всегда отражает день года в григорианском календаре, независимо от текущего календаря языка и региональных параметров. Чтобы получить день года в другом календаре, вызовите Calendar.GetDayOfYear метод этого календаря.

Применяется к

Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

См. также раздел