Skip to content

temporian.EventSet.calendar_day_of_year #

calendar_day_of_year(
    tz: Union[str, float, int] = 0
) -> EventSetOrNode

Obtains the day of year the timestamps in an EventSet's sampling are in.

Features in the input are ignored, only the timestamps are used and they must be unix timestamps (is_unix_timestamp=True).

Output feature contains numbers between 1 and 366.

By default, the timezone is UTC unless the tz argument is specified, as an offset in hours or a timezone name. See EventSet.calendar_hour() for an example using timezones.

Usage example 
>>> a = tp.event_set(
...    timestamps=["2020-01-01", "2021-06-01", "2022-12-31", "2024-12-31"],
... )
>>> b = a.calendar_day_of_year()
>>> b
indexes: ...
features: [('calendar_day_of_year', int32)]
events:
    (4 events):
        timestamps: [...]
        'calendar_day_of_year': [ 1 152 365 366]
...

Parameters:

Name Type Description Default
tz Union[str, float, int]

timezone name (see pytz.all_timezones) or UTC offset in hours.

 0

Returns:

Type Description
EventSetOrNode

EventSet with a single feature with the day of the year each timestamp in sampling belongs to.