Friday, October 17, 2025
HomeLanguagesPython | Pandas tseries.offsets.CustomBusinessHour.rollforward

Python | Pandas tseries.offsets.CustomBusinessHour.rollforward

Dateoffsets are a standard kind of date increment used for a date range in Pandas. It works exactly like relativedelta in terms of the keyword args we pass in. DateOffsets work as follows, each offset specify a set of dates that conform to the DateOffset. For example, Bday defines this set to be the set of dates that are weekdays (M-F). DateOffsets can be created to move dates forward a given 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 on a valid date, first it is moved to a valid date and then offset is created. Pandas tseries.offsets.CustomBusinessHour.rollforward() function is used to roll provided date forward to next offset only if not on offset.

Syntax: pandas.tseries.offsets.CustomBusinessHour.rollforward(dt) Parameter : dt : date Returns : rollforward

Example #1: Use pandas.tseries.offsets.CustomBusinessHour.rollforward() function to roll the provided date forward if it is not on offset. 

Python3




# importing pandas as pd
import pandas as pd
 
# Creating Timestamp
ts = pd.Timestamp('2019-4-23 11:15:00')
 
# Create an offset
cbh = pd.tseries.offsets.CustomBusinessHour(n = 2, weekmask = 'Mon Tue Wed Thu',
                                           start ='12:00')
 
# Print the Timestamp
print(ts)
 
# Print the Offset
print(cbh)


Output : Now we will add the offset to the given timestamp object to increment the datetime value. We will also check if the given date is on offset or not. If not then we will roll forward the given date to the next offset. 

Python3




# Adding the offset to the given timestamp
new_timestamp = ts + cbh
 
# Print the updated timestamp
print(new_timestamp)
 
# roll forward if not on offset
result = cbh.rollforward(pd.Timestamp('2019-4-28 11:15:00'))
 
# print the result
print(result)


Output : As we can see in the output, we have successfully created an offset and added it to the given timestamp. We have also rolled the date forward to next offset. Example #2: Use pandas.tseries.offsets.CustomBusinessHour.rollforward() function to roll the provided date forward if it is not on offset. 

Python3




# importing pandas as pd
import pandas as pd
 
# Creating Timestamp
ts = pd.Timestamp('2019-4-23 11:15:00')
 
# Create an offset
cbh = pd.tseries.offsets.CustomBusinessHour(start ='07:00', end ='14:00')
 
# Print the Timestamp
print(ts)
 
# Print the Offset
print(cbh)


Output : Now we will add the offset to the given timestamp object to increment the datetime value. We will also check if the given date is on offset or not. If not then we will roll forward the given date to the next offset. 

Python3




# Adding the offset to the given timestamp
new_timestamp = ts + cbh
 
# Print the updated timestamp
print(new_timestamp)
 
# roll forward if not on offset
result = cbh.rollforward(pd.Timestamp('2019-4-28 11:15:00'))
 
# print the result
print(result)


Output : As we can see in the output, we have successfully created an offset and added it to the given timestamp. We have also rolled the date forward to next offset.

Dominic
Dominichttp://wardslaus.com
infosec,malicious & dos attacks generator, boot rom exploit philanthropist , wild hacker , game developer,
RELATED ARTICLES

Most Popular

Dominic
32361 POSTS0 COMMENTS
Milvus
88 POSTS0 COMMENTS
Nango Kala
6728 POSTS0 COMMENTS
Nicole Veronica
11892 POSTS0 COMMENTS
Nokonwaba Nkukhwana
11954 POSTS0 COMMENTS
Shaida Kate Naidoo
6852 POSTS0 COMMENTS
Ted Musemwa
7113 POSTS0 COMMENTS
Thapelo Manthata
6805 POSTS0 COMMENTS
Umr Jansen
6801 POSTS0 COMMENTS