Week number for a date
The Week number robot returns the ISO-8601 week number of the year in Bitrix24 business processes and robots. It accepts a date as YYYY-MM-DD, DD.MM.YYYY or a timestamp and returns the week number (1–53), the ISO week-numbering year, and a ready-made label like 2026-W05.
The robot determines the week number of the year for a date using the ISO-8601 standard: weeks start on Monday and week 1 is the week containing the year first Thursday. The input is a single Date field (formats YYYY-MM-DD, DD.MM.YYYY and Unix timestamp are supported). The output is the week number (1 to 53), the ISO week-numbering year, and a label like 2026-W05. The ISO year matters at the year boundary: for example, 1 January 2027 belongs to week 53 of ISO year 2026 — that is why the week year is returned as a separate field. Typical use cases: grouping deals and tasks by week for reporting, weekly triggers and reminders, building a week number into documents and notifications.
What input parameters does the robot accept?
| Parameter | Type | Required? | Default |
|---|---|---|---|
| Date | date | yes |
What does the robot return?
| Parameter | Type |
|---|---|
| Week number (1–53) | int |
| ISO week-numbering year | int |
| Week label (e.g. 2026-W05) | string |
Scenario: weekly grouping of deals
- A deal is created and the business process starts automatically
- The Week number robot computes the week number for the creation date
- The week number is written to a deal field and used for reports and kanban filters