Если бы я читал доку на библиотеку, меньше всего я был бы рад встретить фразу "Commercial day of the week" или ссылку на 30 страниц ISO стандарта, а вот что-то вроде "where 1-Moday, 7-Sunday" было бы в самый раз. А уж почему автор сделал так — это его проблемы, зачем мне знать, какие тараканы у него в голове?