featuretools.primitives.TimeSinceFirst

class featuretools.primitives.TimeSinceFirst(unit='seconds')[source]

Calculates the time elapsed since the first datetime (in seconds).

Description:

Given a list of datetimes, calculate the time elapsed since the first datetime (in seconds). Uses the instance’s cutoff time.

Parameters

unit (str) – Defines the unit of time to count from. Defaults to seconds. Acceptable values: years, months, days, hours, minutes, seconds, milliseconds, nanoseconds

Examples

>>> from datetime import datetime
>>> time_since_first = TimeSinceFirst()
>>> cutoff_time = datetime(2010, 1, 1, 12, 0, 0)
>>> times = [datetime(2010, 1, 1, 11, 45, 0),
...          datetime(2010, 1, 1, 11, 55, 15),
...          datetime(2010, 1, 1, 11, 57, 30)]
>>> time_since_first(times, time=cutoff_time)
900.0
>>> from datetime import datetime
>>> time_since_first = TimeSinceFirst(unit = "minutes")
>>> cutoff_time = datetime(2010, 1, 1, 12, 0, 0)
>>> times = [datetime(2010, 1, 1, 11, 45, 0),
...          datetime(2010, 1, 1, 11, 55, 15),
...          datetime(2010, 1, 1, 11, 57, 30)]
>>> time_since_first(times, time=cutoff_time)
15.0
__init__(unit='seconds')[source]

Initialize self. See help(type(self)) for accurate signature.

Methods

__init__([unit])

Initialize self.

generate_name(base_feature_names, …)

generate_names(base_feature_names, …)

get_args_string()

get_arguments()

get_dask_aggregation()

get_filepath(filename)

get_function()

Attributes

base_of

base_of_exclude

commutative

dask_compatible

default_value

input_types

max_stack_depth

name

number_output_features

stack_on

stack_on_exclude

stack_on_self

uses_calc_time