DOC: update documentation for CustomBusinessHour
- [x] closes #49838
- [x] [Tests added and passed](https://pandas.pydata.org/pandas-docs/dev/development/contributing_codebase.html#writing-tests) if fixing a bug or adding a new feature

Updated documentation for `CustomBusinessHour`. Added missing parameters: `holidays`, `calendar`, and `offset`. Provided more examples.
Thank you, MarcoGorelli,  for reviewing my PR. I'll keep your comments in mind.
The cat looks cute, just a little bit sad. 😄 I didn't choose it, it's taken randomly from https://chriskuehl.github.io/shipit/ (though perhaps I should curate my own list)