Change language

Python | Pandas tseries.offsets.CustomBusinessDay.rollforward

| |

DateOffsets can be created to move dates by a specified number of valid dates. For example, Bday (2) can be added to a date to move it two business days forward. If the date does not start with a valid date, it is first moved to a valid date and then an offset is generated.

tseries.offsets.CustomBusinessDay.rollforward() Pandas tseries.offsets.CustomBusinessDay.rollforward() provided date forward until next offset, unless at offset.

Syntax: pandas.tseries.offsets.CustomBusinessDay.rollforward (dt)

Parameter:
dt: date

Returns: rollforward if not on offset

Example # 1: Use pandas.tseries.offsets .CustomBusinessDay.rollforward () to scroll forward the specified timestamp if it is not in offset.

# import pandas as pd

import pandas as pd

  
# Create a timestamp

ts = pd.Timestamp ( ’2019-4-23 11: 15: 00’ )

 
# Create offset

cbd = pd.tseries.offsets.CustomBusinessDay (weekmask = ’Mon Tue Wed’ )

  
# Print time stamp

print (ts)

  
# Print offset

print (cbd)

Output:

Now we will add an offset to this timestamp object to increase the datetime value. We will also wrap the given timestamp if it is not offset.

# Adds an offset to the specified timestamp

new_timestamp = ts + cbd

 
# Print updated timestamp

print (new_timestamp)

 
# rollback if timestamp is set
# not offset

result = cbd.rollforward (pd.Timestamp ( ’2019-4-21 11: 15: 00’ )) 

 
# print result

print (result)

Output:

As we can see in the output, we have successfully created offset and added it to the given timestamp. We also pushed the specified timestamp as it is not offset.

Example # 2: Use pandas.tseries.offsets.CustomBusinessDay.rollforward () to scrolls forward the specified timestamp if it is not in offset.

# import pandas as pd

import pandas as pd

 
# Create timestamp

ts = pd.Timestamp ( ’2019-4-23 11: 15: 00’ )

 
# Create offset

cbd = pd. tseries.offsets.CustomBusinessDay (n = 3 , weekmask = ’Mon Tue Wed Thu’ )

 
# Print time stamp

print (ts)

 
# Print offset

print (cbd)

Output:

We will now add an offset to the given timestamp object to increment the datetime value. We will also roll back the given timestamp if it is not offset.

# Adds an offset to the specified timestamp

new_timestamp = ts + cbd

 
# Print updated timestamp

print (new_timestamp)

 
# rollback if timestamp is set
# not offset

result = cbd.rollforward (pd.Timestamp ( ’2019-4-21 11: 15: 00’ )) 

 
# print result

print (result)

Output:

As we can see in the output, we have successfully created an offset and added it to the given label time. We have also moved the specified timestamp forward as it is not offset.