PlanMaker WEEKNUM Function: Sunday, Monday and ISO Weeks
Use WEEKNUM in SoftMaker PlanMaker to calculate calendar-week numbers with Sunday, Monday or ISO 8601 settings, with test data and year-boundary examples.
Verification status: Official documentation referenced; example outcomes independently reasoned or arithmetically checked where stated. Not executed in SoftMaker PlanMaker 2026. How formula examples are checked
Quick answer: =WEEKNUM(DATE(2020,1,5)) is expected to return 2, while =WEEKNUM(DATE(2020,1,5),2) is expected to return 1. The first expression uses Sunday-start weeks by default, and the second uses Monday-start weeks, but both ordinarily count the week containing January 1 as week 1. For internationally standardized week reporting, use =WEEKNUM(A2,21) or =ISOWEEKNUM(A2) instead. These examples follow the official PlanMaker 2026 WEEKNUM reference and independent date arithmetic.
Validation: Examples were independently calculated from documented calendar rules. No native PlanMaker or Excel execution was performed.
Why week-number conventions matter
Week numbers are useful for shipments, timesheets, seasonal dashboards and recurring reports. They are not universally defined: a Sunday-based calendar, a Monday-based calendar that always starts with the January 1 week, and the ISO 8601 week-year system can produce different week numbers for the same date. If two departments combine reports without specifying their chosen convention, records near the new year may be grouped differently.
WEEKNUM returns a number identifying a calendar week; it does not return a complete date, weekday name, or unique year–week key. PlanMaker’s default is the week-start convention used commonly in the United States. Official WEEKNUM documentation.
Exact official syntax, argument order and defaults
=WEEKNUM(Date [, WeekStartsOn])
| Argument | Required? | Meaning and accepted documented values | Default |
|---|---|---|---|
Date |
Yes | A date value, usually a date-valued cell or a DATE(...) expression. |
None. |
WeekStartsOn |
No | Calendar convention: 1/2, 11–17, or ISO mode 21. See the complete table below. |
1: Sunday start, week containing January 1 is week 1. |
Brackets denote an optional argument in SoftMaker’s reference; do not type the square brackets. The single comma shown in the English documentation separates arguments. Formula separators and date display/input formats may differ across locales; use your installation’s function insertion UI to confirm any localized separators. For unambiguous portable practice formulas, use numeric DATE(year,month,day) inputs rather than typing ambiguous text like 01/05/2020. The vendor documents numeric date storage and regional date-entry behaviour in Entering data in cells.
Which WeekStartsOn mode should you choose?
| Mode | First day of week | Rule for week 1 | Best use |
|---|---|---|---|
omitted or 1 |
Sunday | Week containing January 1 | Sunday-start weekly reports |
2 or 11 |
Monday | Week containing January 1 | Monday-start non-ISO reports |
12 |
Tuesday | Week containing January 1 | Specialized Tuesday cycles |
13 |
Wednesday | Week containing January 1 | Specialized Wednesday cycles |
14 |
Thursday | Week containing January 1 | Specialized Thursday cycles |
15 |
Friday | Week containing January 1 | Specialized Friday cycles |
16 |
Saturday | Week containing January 1 | Specialized Saturday cycles |
17 |
Sunday | Week containing January 1 | Alternate Sunday code |
21 |
Monday | Week containing January 4 (ISO 8601) | ISO weekly reporting |
This complete enumeration follows SoftMaker’s function reference; 2 and 11 specify the same Monday-start rule. Changing the first day from Sunday to Monday is not the same as enabling ISO weeks. Only the special value 21 selects the ISO week-1 rule.
Build a reproducible worksheet
Open a blank sheet. Put headers in A1:E1: Date, Sunday week, Monday week, ISO week (mode 21), ISOWEEKNUM. In A2:A11 enter the DATE(...) formulas shown below, one per row. Display column A as a Date. In B2 enter =WEEKNUM(A2,1), C2 enter =WEEKNUM(A2,2), D2 enter =WEEKNUM(A2,21) and E2 enter =ISOWEEKNUM(A2). Fill B2:E2 down to row 11. A genuine date should be stored as a numeric date value; a date-looking text string is not a reliable substitute. The final ISO-year column below is context calculated outside PlanMaker, not an extra formula entered on the sheet.
Independent expected-output table (Python calendar arithmetic and datetime.date.isocalendar, not observed software output):
| Row | A: Date formula | Date represented | B: WEEKNUM(A,1) |
C: WEEKNUM(A,2) |
D: WEEKNUM(A,21) |
E: ISOWEEKNUM(A) |
ISO year |
|---|---|---|---|---|---|---|---|
| 2 | =DATE(2016,12,31) |
2016-12-31 (Saturday) | 53 | 53 | 52 | 52 | 2016 |
| 3 | =DATE(2017,1,1) |
2017-01-01 (Sunday) | 1 | 1 | 52 | 52 | 2016 |
| 4 | =DATE(2019,12,30) |
2019-12-30 (Monday) | 53 | 53 | 1 | 1 | 2020 |
| 5 | =DATE(2020,1,1) |
2020-01-01 (Wednesday) | 1 | 1 | 1 | 1 | 2020 |
| 6 | =DATE(2020,1,5) |
2020-01-05 (Sunday) | 2 | 1 | 1 | 1 | 2020 |
| 7 | =DATE(2021,1,1) |
2021-01-01 (Friday) | 1 | 1 | 53 | 53 | 2020 |
| 8 | =DATE(2021,1,4) |
2021-01-04 (Monday) | 2 | 2 | 1 | 1 | 2021 |
| 9 | =DATE(2022,1,1) |
2022-01-01 (Saturday) | 1 | 1 | 52 | 52 | 2021 |
| 10 | =DATE(2024,12,30) |
2024-12-30 (Monday) | 53 | 53 | 1 | 1 | 2025 |
| 11 | =DATE(2025,1,1) |
2025-01-01 (Wednesday) | 1 | 1 | 1 | 1 | 2025 |
A week number alone is insufficient to identify a reporting period: 2019-12-30 has ISO week 1 of 2020, and 2024-12-30 has ISO week 1 of 2025. Do not pair ISO week numbers with the ordinary calendar year without checking the ISO year separately.
Walkthrough: vendor’s January 5, 2020 example
- In A2 on a fresh worksheet enter
=DATE(2020,1,5)and format A2 as Date. - In B2 enter
=WEEKNUM(A2,1). Independently expected 2: Sunday January 5 begins the second Sunday-based week of 2020. - In C2 enter
=WEEKNUM(A2,2). Independently expected 1: Monday December 30 began the week containing January 1, and the next Monday does not arrive until January 6. - In D2 enter
=WEEKNUM(A2,21). Independently expected 1: ISO 2020 week 1 spans December 30, 2019–January 5, 2020. - In E2 enter
=ISOWEEKNUM(A2). Independently expected 1, equivalent to mode21for documented ISO behaviour.
SoftMaker itself supplies examples for January 5, 2020 with modes 1 and 2 in its 2026 WEEKNUM page. The source uses a quoted U.S.-style date string; the worksheet above instead constructs an unambiguous date value.
Advanced case 1: grouping weekly sales correctly
Suppose A2:A11 are order dates. To group shipments by Monday-start non-ISO weeks, use =WEEKNUM(A2,2) in a helper column, then aggregate by both the calendar year and the calculated week. If your organization requires ISO reporting, use =WEEKNUM(A2,21) and group by ISO week-year, not YEAR(A2). For December 30, 2024, YEAR(A2) is independently expected 2024, yet the ISO year is 2025: joining them as 2024-W01 is a labeling error.
PlanMaker documents a separate, non-Excel-compatible function, ISOWEEK(Date [, ReturnYear]): =ISOWEEK(A2,1) asks for the ISO year, and =ISOWEEK(A2) for the ISO week. The expected ISO year for December 30, 2024 is 2025, but this formula has not been executed here. SoftMaker ISOWEEK reference.
Advanced case 2: compare week-start conventions without a hidden locale setting
For any date A2, place =WEEKNUM(A2) and =WEEKNUM(A2,11) in adjacent cells; the first uses Sunday and the second Monday. Compare against =WEEKNUM(A2,21) to reveal any difference caused by the ISO week-1 rule, especially near New Year’s Day. Example: for 2021-01-01, independently expected values are 1, 1 and 53, respectively. The ISO result belongs to ISO year 2020.
Keep the week convention in a documented report column or a visible heading; otherwise future editors may interpret the same result as another standard. If a workbook moves into Excel, documented numeric mode values generally align, but date serials, locale parsing and untested edge cases still need checking.
Advanced case 3: weekday versus week-of-year
WEEKDAY(A2,2) answers which day of the week a date falls on (Monday=1 through Sunday=7), not which numbered week of the year it belongs to. For January 5, 2020, the independently expected WEEKDAY(A2,2) result is 7 (Sunday); WEEKNUM(A2,2) is expected 1. These functions are not interchangeable. SoftMaker WEEKDAY reference.
Troubleshooting and error boundaries
| Symptom | Likely reason | Verification or remedy |
|---|---|---|
| Week 1 differs from a European/ISO report | WeekStartsOn=2 starts Monday but still uses the week containing January 1. |
Use 21 or ISOWEEKNUM for ISO; check the associated ISO year. |
| Expected week 2 but got week 1 on Jan 5, 2020 | Different Sunday/Monday convention. | Compare explicitly with 1 and 2; independently expected 2 and 1. |
| Date appears correct but formula is unreliable | Date may be text, or regional parsing is different. | Use a numeric date value (e.g., DATE(...)); format the input date as Date and the week-number result as Number; avoid ambiguous month/day strings. |
| Same ISO week appears in two calendar years | ISO weeks can cross year boundaries. | Associate ISO week number with ISO year; avoid YEAR(date) as an ISO-year label. |
Function errors with arbitrary mode such as 8 |
8 is not in SoftMaker’s documented list. |
Use documented modes; do not assume a specific PlanMaker error text without native tests. |
| Formula punctuation not accepted | Installation may use different formula list separators. | Check localized formula separator, inserted-function UI, and quoted literal syntax. |
| Historic dates give unexpected numbers | Program-specific date-base/range constraints or typed text. | Test a genuine date inside documented 1900–2500 input range; never assume Excel and PlanMaker have identical date bases. |
The specific error codes and invalid-input coercion for PlanMaker are not established by these documentation checks; test invalid dates, unsupported mode values, empty cells and nonnumeric strings natively before claiming exact responses. The vendor’s date-entry documentation documents January 1, 1900–December 31, 2500 as a date-entry range.
PlanMaker versions, platforms, locales and Excel compatibility
The WEEKNUM syntax and documented mode list were checked in official English manuals for PlanMaker 2021, 2024 and 2026, all on 2026-10-12. The presence of documentation does not prove the earliest version supporting the function, nor behavior in every platform/edition/localization: native Windows/macOS/Linux tests were not conducted. The formula examples use the English names and comma notation of those manuals.
Microsoft Excel WEEKNUM documentation describes WEEKNUM(serial_number,[return_type]) with modes 1, 2, 11–17 and 21; SoftMaker specifically warns that Excel modes 11–17/21 require Excel 2010 or later. Excel uses a different argument name (return_type) but shares the documented week conventions; this does not imply that locale/date-string parsing, error codes, or export roundtrips are identical. PlanMaker 2026.
Official references and validation ledger (accessed 2026-10-12 UTC)
- SoftMaker PlanMaker 2026: WEEKNUM — exact syntax, default, all mode values, example, Excel-2010 mode note.
- SoftMaker PlanMaker 2024: WEEKNUM and PlanMaker 2021: WEEKNUM — compared function documentation and version presence.
- SoftMaker PlanMaker 2026: ISOWEEKNUM and ISOWEEK — ISO vs calendar conventions, special ISO-year argument for ISOWEEK.
- SoftMaker PlanMaker 2026: WEEKDAY — weekday numbering differences.
- SoftMaker: Entering data in cells — dates as numbers, locale considerations, input range and formula prefix.
- Microsoft Support: Excel WEEKNUM — Excel syntax and mode semantics, not evidence of PlanMaker native behavior.
Claim/validation classification: Official syntax/version/defaults and reference examples = documentation check; 10-date table, ISO-year rollover and calculations = independent Gregorian arithmetic; PlanMaker formula results = expected, not observed; unsupported-input error names, runtime/platform parity = not verified.