pandas.tseries.offsets.Second

class pandas.tseries.offsets.Second

Offset n seconds.

Represents a fixed duration of n seconds for use in arithmetic with datetime-like objects. The smallest tick offset that does not involve fractional seconds.

Attributes

n	Return the count of the number of periods.

See also

DateOffset

Standard kind of date increment.

Examples

You can use the parameter n to represent a shift of n seconds.

>>> from pandas.tseries.offsets import Second
>>> ts = pd.Timestamp(2022, 12, 9, 15)
>>> ts
Timestamp('2022-12-09 15:00:00')

>>> ts + Second(n=10)
Timestamp('2022-12-09 15:00:10')
>>> ts - Second(n=10)
Timestamp('2022-12-09 14:59:50')

>>> ts + Second(n=-10)
Timestamp('2022-12-09 14:59:50')

Attributes

base	Returns a copy of the calling offset object with n=1 and all other attributes equal.
freqstr	Return a string representing the frequency.
kwds	Return a dict of extra parameters for the offset.
n	Return the count of the number of periods.
name	Return a string representing the base frequency.
nanos	Returns an integer of the total number of nanoseconds.
normalize	Return boolean whether the frequency can align with midnight.
rule_code	Return a string representing the base frequency.

Methods

copy()	Return a copy of the frequency.
is_month_end(ts)	Return boolean whether a timestamp occurs on the month end.
is_month_start(ts)	Return boolean whether a timestamp occurs on the month start.
is_on_offset(dt)	Return boolean whether a timestamp intersects with this frequency.
is_quarter_end(ts)	Return boolean whether a timestamp occurs on the quarter end.
is_quarter_start(ts)	Return boolean whether a timestamp occurs on the quarter start.
is_year_end(ts)	Return boolean whether a timestamp occurs on the year end.
is_year_start(ts)	Return boolean whether a timestamp occurs on the year start.
rollback(dt)	Roll provided date backward to next offset only if not on offset.
rollforward(dt)	Roll provided date forward to next offset only if not on offset.