timeofweek

Timeofweek is a temporal concept used to designate a specific time within a calendar week. It is commonly employed in scheduling, data processing, and reporting to express events or windows that recur on a weekly basis.

Definition and format

Timeofweek typically combines two elements: the day of the week and the time of day. In many systems this appears as a pair (day_of_week, time_of_day), where day_of_week ranges from Monday to Sunday and time_of_day is specified in hours, minutes, and seconds. Some representations encode this as a single value, such as minutes or seconds elapsed since the start of the week. ISO week date formats can also express a time within a week, for example, a timestamp like 2024-W12-3T09:15:00 indicates the third day (often Tuesday) of week 12 in 2024 at 09:15:00.

Formats in practice

Common human-readable forms include Mon 08:00 or Tue 14:30. Numeric encodings may store day_of_week as 1–7 with 0–86399 seconds for the time of day, or a combined elapsed-minutes-from-week-start value. In scheduling systems inspired by cron, weekly recurrence is expressed by a day-of-week and a specific time.

Time zones and regional concerns

Timeofweek is typically a local concept, tied to a specific time zone or offset. When scheduling across zones, systems should record the associated time zone or offset to preserve the intended local time, especially around daylight saving transitions.

Applications and considerations

Uses include recurring maintenance windows, weekly data aggregation, and reporting周期s. Ambiguities arise if the time zone is omitted or if the week definition varies (ISO Monday start vs. other conventions). Proper handling of timeofweek requires clear time zone information and consistent week definitions.