day_of_year

Author: oleksii-polovyi

asv_bench/benchmarks/period.py

@@ -8,7 +8,7 @@ class PeriodProperties(object):
     params = (['M', 'min'],
               ['year', 'month', 'day', 'hour', 'minute', 'second',
                'is_leap_year', 'quarter', 'qyear', 'week', 'daysinmonth',
-               'dayofweek', 'dayofyear', 'start_time', 'end_time'])
+               'dayofweek', 'day_of_year', 'start_time', 'end_time'])
     param_names = ['freq', 'attr']
 
     def setup(self, freq, attr):

asv_bench/benchmarks/timestamp.py

@@ -50,7 +50,7 @@ def time_weekday_name(self, tz, freq):
         self.ts.day_name
 
     def time_dayofyear(self, tz, freq):
-        self.ts.dayofyear
+        self.ts.day_of_year
 
     def time_week(self, tz, freq):
         self.ts.week

doc/source/reference/indexing.rst

@@ -350,6 +350,7 @@ Time/Date Components
    DatetimeIndex.time
    DatetimeIndex.timetz
    DatetimeIndex.dayofyear
+   DatetimeIndex.day_of_year
    DatetimeIndex.weekofyear
    DatetimeIndex.week
    DatetimeIndex.dayofweek
@@ -452,7 +453,7 @@ Properties
 
     PeriodIndex.day
     PeriodIndex.dayofweek
-    PeriodIndex.dayofyear
+    PeriodIndex.day_of_year
     PeriodIndex.days_in_month
     PeriodIndex.daysinmonth
     PeriodIndex.end_time

doc/source/reference/series.rst

@@ -327,7 +327,7 @@ Datetime Properties
    Series.dt.weekofyear
    Series.dt.dayofweek
    Series.dt.weekday
-   Series.dt.dayofyear
+   Series.dt.day_of_year
    Series.dt.quarter
    Series.dt.is_month_start
    Series.dt.is_month_end

doc/source/user_guide/timeseries.rst

@@ -808,7 +808,7 @@ There are several time/date properties that one can access from ``Timestamp`` or
     date,"Returns datetime.date (does not contain timezone information)"
     time,"Returns datetime.time (does not contain timezone information)"
     timetz,"Returns datetime.time as local time with timezone information"
-    dayofyear,"The ordinal day of year"
+    day_of_year,"The ordinal day of year"
     weekofyear,"The week ordinal of the year"
     week,"The week ordinal of the year"
     dayofweek,"The number of the day of the week with Monday=0, Sunday=6"

pandas/_libs/tslibs/nattype.pyx

@@ -314,7 +314,7 @@ class NaTType(_NaT):
     nanosecond = property(fget=lambda self: np.nan)
 
     week = property(fget=lambda self: np.nan)
-    dayofyear = property(fget=lambda self: np.nan)
+    day_of_year = property(fget=lambda self: np.nan)
     weekofyear = property(fget=lambda self: np.nan)
     days_in_month = property(fget=lambda self: np.nan)
     daysinmonth = property(fget=lambda self: np.nan)

pandas/_libs/tslibs/period.pyx

@@ -1748,7 +1748,7 @@ cdef class _Period(object):
         See Also
         --------
         Period.end_time : Return the end Timestamp.
-        Period.dayofyear : Return the day of year.
+        Period.day_of_year : Return the day of year.
         Period.daysinmonth : Return the days in that month.
         Period.dayofweek : Return the day of the week.
 
@@ -1832,7 +1832,7 @@ cdef class _Period(object):
         See Also
         --------
         Period.dayofweek : Get the day of the week.
-        Period.dayofyear : Get the day of the year.
+        Period.day_of_year : Get the day of the year.
 
         Examples
         --------
@@ -1978,7 +1978,7 @@ cdef class _Period(object):
         Period.dayofweek : Day of the week the period lies in.
         Period.weekday : Alias of Period.dayofweek.
         Period.day : Day of the month.
-        Period.dayofyear : Day of the year.
+        Period.day_of_year : Day of the year.
 
         Examples
         --------
@@ -2029,7 +2029,7 @@ cdef class _Period(object):
         Period.dayofweek : Day of the week the period lies in.
         Period.weekday : Alias of Period.dayofweek.
         Period.day : Day of the month.
-        Period.dayofyear : Day of the year.
+        Period.day_of_year : Day of the year.
 
         Examples
         --------
@@ -2061,7 +2061,7 @@ cdef class _Period(object):
         return self.dayofweek
 
     @property
-    def dayofyear(self):
+    def day_of_year(self):
         """
         Return the day of the year.
 
@@ -2078,18 +2078,18 @@ cdef class _Period(object):
         --------
         Period.day : Return the day of the month.
         Period.dayofweek : Return the day of week.
-        PeriodIndex.dayofyear : Return the day of year of all indexes.
+        PeriodIndex.day_of_year : Return the day of year of all indexes.
 
         Examples
         --------
         >>> period = pd.Period("2015-10-23", freq='H')
-        >>> period.dayofyear
+        >>> period.day_of_year
         296
         >>> period = pd.Period("2012-12-31", freq='D')
-        >>> period.dayofyear
+        >>> period.day_of_year
         366
         >>> period = pd.Period("2013-01-01", freq='D')
-        >>> period.dayofyear
+        >>> period.day_of_year
         1
         """
         base, mult = get_freq_code(self.freq)
@@ -2190,7 +2190,7 @@ cdef class _Period(object):
         See Also
         --------
         Period.days_in_month : Return the days of the month.
-        Period.dayofyear : Return the day of the year.
+        Period.day_of_year : Return the day of the year.
 
         Examples
         --------

pandas/_libs/tslibs/timestamps.pyx

@@ -1022,7 +1022,7 @@ class Timestamp(_Timestamp):
         return self.day_name()
 
     @property
-    def dayofyear(self):
+    def day_of_year(self):
         """
         Return the day of the year.
         """

pandas/core/arrays/datetimes.py

@@ -250,7 +250,7 @@ class DatetimeArray(dtl.DatetimeLikeArrayMixin,
     _object_ops = ['weekday_name', 'freq', 'tz']
     _field_ops = ['year', 'month', 'day', 'hour', 'minute', 'second',
                   'weekofyear', 'week', 'weekday', 'dayofweek',
-                  'dayofyear', 'quarter', 'days_in_month',
+                  'day_of_year', 'quarter', 'days_in_month',
                   'daysinmonth', 'microsecond',
                   'nanosecond']
     _other_ops = ['date', 'time', 'timetz']
@@ -1368,7 +1368,7 @@ def date(self):
         'weekday_name',
         "The name of day in a week (ex: Friday)\n\n.. deprecated:: 0.23.0")
 
-    dayofyear = _field_accessor('dayofyear', 'doy',
+    day_of_year = _field_accessor('day_of_year', 'doy',
                                 "The ordinal day of the year.")
     quarter = _field_accessor('quarter', 'q', "The quarter of the date.")
     days_in_month = _field_accessor(

pandas/core/arrays/period.py

@@ -137,7 +137,7 @@ class PeriodArray(dtl.DatetimeLikeArrayMixin, dtl.DatelikeOps):
     _object_ops = ['start_time', 'end_time', 'freq']
     _field_ops = ['year', 'month', 'day', 'hour', 'minute', 'second',
                   'weekofyear', 'weekday', 'week', 'dayofweek',
-                  'dayofyear', 'quarter', 'qyear',
+                  'day_of_year', 'quarter', 'qyear',
                   'days_in_month', 'daysinmonth']
     _datetimelike_ops = _field_ops + _object_ops + _bool_ops
     _datetimelike_methods = ['strftime', 'to_timestamp', 'asfreq']
@@ -296,7 +296,7 @@ def __array__(self, dtype=None):
     dayofweek = _field_accessor('dayofweek', 10,
                                 "The day of the week with Monday=0, Sunday=6")
     weekday = dayofweek
-    dayofyear = day_of_year = _field_accessor('dayofyear', 9,
+    day_of_year = _field_accessor('day_of_year', 9,
                                               "The ordinal day of the year")
     quarter = _field_accessor('quarter', 2, "The quarter of the date")
     qyear = _field_accessor('qyear', 1)

pandas/core/indexes/datetimes.py

@@ -172,7 +172,7 @@ class DatetimeIndex(DatetimeIndexOpsMixin, Int64Index, DatetimeDelegateMixin):
     date
     time
     timetz
-    dayofyear
+    day_of_year
     weekofyear
     week
     dayofweek

pandas/core/indexes/period.py

@@ -121,7 +121,7 @@ class PeriodIndex(DatetimeIndexOpsMixin, Int64Index, PeriodDelegateMixin):
     ----------
     day
     dayofweek
-    dayofyear
+    day_of_year
     days_in_month
     daysinmonth
     end_time

pandas/tests/indexes/datetimes/test_misc.py

@@ -107,8 +107,8 @@ def test_datetimeindex_accessors(self):
             assert dti.microsecond[0] == 0
             assert dti.dayofweek[0] == 3
 
-            assert dti.dayofyear[0] == 1
-            assert dti.dayofyear[120] == 121
+            assert dti.day_of_year[0] == 1
+            assert dti.day_of_year[120] == 121
 
             assert dti.weekofyear[0] == 1
             assert dti.weekofyear[120] == 18
@@ -145,7 +145,7 @@ def test_datetimeindex_accessors(self):
             assert len(dti.second) == 365
             assert len(dti.microsecond) == 365
             assert len(dti.dayofweek) == 365
-            assert len(dti.dayofyear) == 365
+            assert len(dti.day_of_year) == 365
             assert len(dti.weekofyear) == 365
             assert len(dti.quarter) == 365
             assert len(dti.is_month_start) == 365

pandas/tests/indexes/datetimes/test_scalar_compat.py

@@ -39,7 +39,7 @@ def test_dti_date_out_of_range(self, data):
             DatetimeIndex(data)
 
     @pytest.mark.parametrize('field', [
-        'dayofweek', 'dayofyear', 'week', 'weekofyear', 'quarter',
+        'dayofweek', 'day_of_year', 'week', 'weekofyear', 'quarter',
         'days_in_month', 'is_month_start', 'is_month_end',
         'is_quarter_start', 'is_quarter_end', 'is_year_start',
         'is_year_end', 'weekday_name'])

pandas/tests/indexes/period/test_period.py

@@ -249,7 +249,7 @@ def test_period_index_length(self):
 
     def test_fields(self):
         # year, month, day, hour, minute
-        # second, weekofyear, week, dayofweek, weekday, dayofyear, quarter
+        # second, weekofyear, week, dayofweek, weekday, day_of_year, quarter
         # qyear
         pi = period_range(freq='A', start='1/1/2001', end='12/1/2005')
         self._check_all_fields(pi)
@@ -282,7 +282,7 @@ def test_fields(self):
 
     def _check_all_fields(self, periodindex):
         fields = ['year', 'month', 'day', 'hour', 'minute', 'second',
-                  'weekofyear', 'week', 'dayofweek', 'dayofyear',
+                  'weekofyear', 'week', 'dayofweek', 'day_of_year',
                   'quarter', 'qyear', 'days_in_month']
 
         periods = list(periodindex)

pandas/tests/reshape/test_pivot.py

@@ -1034,10 +1034,10 @@ def test_daily(self):
         ts = Series(np.random.randn(len(rng)), index=rng)
 
         annual = pivot_table(DataFrame(ts), index=ts.index.year,
-                             columns=ts.index.dayofyear)
+                             columns=ts.index.day_of_year)
         annual.columns = annual.columns.droplevel(0)
 
-        doy = np.asarray(ts.index.dayofyear)
+        doy = np.asarray(ts.index.day_of_year)
 
         for i in range(1, 367):
             subset = ts[doy == i]

pandas/tests/scalar/period/test_period.py

@@ -855,7 +855,7 @@ def test_properties_daily(self):
         assert b_date.month == 1
         assert b_date.day == 1
         assert b_date.weekday == 0
-        assert b_date.dayofyear == 1
+        assert b_date.day_of_year == 1
         assert b_date.days_in_month == 31
         assert Period(freq='B', year=2012,
                       month=2, day=1).days_in_month == 29
@@ -867,7 +867,7 @@ def test_properties_daily(self):
         assert d_date.month == 1
         assert d_date.day == 1
         assert d_date.weekday == 0
-        assert d_date.dayofyear == 1
+        assert d_date.day_of_year == 1
         assert d_date.days_in_month == 31
         assert Period(freq='D', year=2012, month=2,
                       day=1).days_in_month == 29
@@ -883,7 +883,7 @@ def test_properties_hourly(self):
             assert h_date.month == 1
             assert h_date.day == 1
             assert h_date.weekday == 0
-            assert h_date.dayofyear == 1
+            assert h_date.day_of_year == 1
             assert h_date.hour == 0
             assert h_date.days_in_month == 31
             assert Period(freq='H', year=2012, month=2, day=1,
@@ -898,7 +898,7 @@ def test_properties_minutely(self):
         assert t_date.month == 1
         assert t_date.day == 1
         assert t_date.weekday == 0
-        assert t_date.dayofyear == 1
+        assert t_date.day_of_year == 1
         assert t_date.hour == 0
         assert t_date.minute == 0
         assert t_date.days_in_month == 31
@@ -915,7 +915,7 @@ def test_properties_secondly(self):
         assert s_date.month == 1
         assert s_date.day == 1
         assert s_date.weekday == 0
-        assert s_date.dayofyear == 1
+        assert s_date.day_of_year == 1
         assert s_date.hour == 0
         assert s_date.minute == 0
         assert s_date.second == 0

pandas/tests/scalar/timestamp/test_timestamp.py

@@ -67,7 +67,7 @@ def check(value, equal):
         check(ts.nanosecond, 1)
         check(ts.dayofweek, 6)
         check(ts.quarter, 2)
-        check(ts.dayofyear, 130)
+        check(ts.day_of_year, 130)
         check(ts.week, 19)
         check(ts.daysinmonth, 31)
         check(ts.daysinmonth, 31)
@@ -87,7 +87,7 @@ def check(value, equal):
         check(ts.nanosecond, 0)
         check(ts.dayofweek, 2)
         check(ts.quarter, 4)
-        check(ts.dayofyear, 365)
+        check(ts.day_of_year, 365)
         check(ts.week, 1)
         check(ts.daysinmonth, 31)