xarray.core.accessor_dt.DatetimeAccessor¶
-
class
xarray.core.accessor_dt.
DatetimeAccessor
(obj)¶ Access datetime fields for DataArrays with datetime-like dtypes.
Fields can be accessed through the .dt attribute for applicable DataArrays.
Notes
Note that these fields are not calendar-aware; if your datetimes are encoded with a non-Gregorian calendar (e.g. a 360-day calendar) using cftime, then some fields like dayofyear may not be accurate.
Examples
>>> import xarray as xr >>> import pandas as pd >>> dates = pd.date_range(start='2000/01/01', freq='D', periods=10) >>> ts = xr.DataArray(dates, dims=('time')) >>> ts <xarray.DataArray (time: 10)> array(['2000-01-01T00:00:00.000000000', '2000-01-02T00:00:00.000000000', '2000-01-03T00:00:00.000000000', '2000-01-04T00:00:00.000000000', '2000-01-05T00:00:00.000000000', '2000-01-06T00:00:00.000000000', '2000-01-07T00:00:00.000000000', '2000-01-08T00:00:00.000000000', '2000-01-09T00:00:00.000000000', '2000-01-10T00:00:00.000000000'], dtype='datetime64[ns]') Coordinates: * time (time) datetime64[ns] 2000-01-01 2000-01-02 ... 2000-01-10 >>> ts.dt <xarray.core.accessor_dt.DatetimeAccessor object at 0x118b54d68> >>> ts.dt.dayofyear <xarray.DataArray 'dayofyear' (time: 10)> array([ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10]) Coordinates: * time (time) datetime64[ns] 2000-01-01 2000-01-02 ... 2000-01-10 >>> ts.dt.quarter <xarray.DataArray 'quarter' (time: 10)> array([1, 1, 1, 1, 1, 1, 1, 1, 1, 1]) Coordinates: * time (time) datetime64[ns] 2000-01-01 2000-01-02 ... 2000-01-10
-
__init__
(obj)¶ Initialize self. See help(type(self)) for accurate signature.
Methods
__init__
(obj)Initialize self. ceil
(freq)Round timestamps upward to specified frequency resolution. floor
(freq)Round timestamps downward to specified frequency resolution. round
(freq)Round timestamps to specified frequency resolution. strftime
(date_format)Return an array of formatted strings specified by date_format, which supports the same string format as the python standard library. Attributes
day
The days of the datetime dayofweek
The day of the week with Monday=0, Sunday=6 dayofyear
The ordinal day of the year days_in_month
The number of days in the month daysinmonth
The number of days in the month hour
The hours of the datetime is_leap_year
Boolean indicator if the date belongs to a leap year. is_month_end
Indicates whether the date is the last day of the month. is_month_start
Indicates whether the date is the first day of the month. is_quarter_end
Indicator for whether the date is the last day of a quarter. is_quarter_start
Indicator for whether the date is the first day of a quarter. is_year_end
Indicate whether the date is the last day of the year. is_year_start
Indicate whether the date is the first day of a year. microsecond
The microseconds of the datetime minute
The minutes of the datetime month
The month as January=1, December=12 nanosecond
The nanoseconds of the datetime quarter
The quarter of the date season
Season of the year second
The seconds of the datetime time
Timestamps corresponding to datetimes week
The week ordinal of the year weekday
The day of the week with Monday=0, Sunday=6 weekday_name
The name of day in a week weekofyear
The week ordinal of the year year
The year of the datetime -