I don't see any real motivation to have this as api funtions visible to users, it's something you would just use internally.  If a user needs this information, they (should) have it from when they set up the clock themselves in the first place