xarray.core.accessor_dt.DatetimeAccessor¶
-
class
xarray.core.accessor_dt.
DatetimeAccessor
(obj)¶ Access datetime fields for DataArrays with datetime-like dtypes.
Similar to pandas, fields can be accessed through the .dt attribute for applicable DataArrays:
>>> ds = xarray.Dataset({'time': pd.date_range(start='2000/01/01', ... freq='D', periods=100)}) >>> ds.time.dt <xarray.core.accessors.DatetimeAccessor at 0x10c369f60> >>> ds.time.dt.dayofyear[:5] <xarray.DataArray 'dayofyear' (time: 5)> array([1, 2, 3, 4, 5], dtype=int32) Coordinates: * time (time) datetime64[ns] 2000-01-01 2000-01-02 2000-01-03 ...
All of the pandas fields are accessible here. 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.
-
__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
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 (ex: DJF)
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 (ex: Friday)
weekofyear
The week ordinal of the year
year
The year of the datetime
-