Пример
date-fns 4.4.0: Calculate business day spans across weekend boundaries, advance or decrement business days, and list interval weekends with date-fns
Проверенный пример — npm date-fns 4.4.0: Calculate business day spans across weekend boundaries, advance or decrement business days, and list interval…
sha256:f8f6ad085cc31fc09fc8715073c9fd615e0f0205060ae9033fec3d8ba026dc3a
Эта сеть предлагает одно: образец, который собирается. Она запустила его в песочнице и сохранила подписанную квитанцию. Она ничего не оценивает и ничего не гарантирует — собирается ли тот же код у вас, она не измеряла.
Сколько различных ключей подписи подали пройденную квитанцию контракта. Один — только автор; больше одного — значит, кто-то ещё тоже собрал. Ключ создаётся сам и не имеет зарегистрированной личности, поэтому считаются ключи, а не люди.
MIT-0
Свидетельства выполнения
Заявленное окружение и подписанные запуски разделены, чтобы вы точно видели, что этот образец запускал и где.
- Основа свидетельства
- Подписанный контракт пройден
- Квитанции проверки
- 3
- Ключи подписи, собравшие его
- 3
Заявленная среда
node linux x64 node node npm
Среды запусков проверки
| Окружение | Контракт | Этапы | Запуск |
|---|---|---|---|
| node 22 · linux alpine/x64 · docker ed25519:d91480838ac982c9 | PASS | compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS CONTAINER_RUN · node-typescript@1 |
2026-08-17 |
| node 22 · linux alpine/x64 · docker ed25519:2175b912ea1c23b1 | PASS | compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS CONTAINER_RUN · node-typescript@1 |
2026-08-18 |
| node 22 · linux alpine/x64 · docker ed25519:c1973797be207ac4 | PASS | compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS CONTAINER_RUN · node-typescript@1node:22-alpine@sha256:c610fcdfb1d5… |
2026-09-08 |
Кейс
HOW- Цель
- Calculate business day spans across weekend boundaries, advance or decrement business days, and list interval weekends with date-fns
- Пакеты
- Символы
-
- differenceInBusinessDays
- addBusinessDays
- subBusinessDays
- isWeekend
- eachWeekendOfInterval
- Окружение
- node
- Создан
- 2026-08-17T18:06:54Z
Контракт
- differenceInBusinessDays from Saturday or Sunday to Monday returns 0 because no full business day elapsed, whereas Friday to Saturday returns 1
- differenceInBusinessDays from Friday to Monday returns 1 business day, skipping the intervening weekend
- differenceInBusinessDays preserves signed negative values when earlier date is compared to later date
- addBusinessDays on Saturday with amount 0 preserves the Saturday date instead of advancing to Monday
- addBusinessDays advances weekend dates to Monday for positive amounts and subBusinessDays decrements to Friday for negative steps
- isWeekend identifies Saturday and Sunday while returning false for Monday through Friday
- eachWeekendOfInterval returns descending weekend dates for inverted intervals without throwing RangeError
Файлы
- NOTES.md
- csx.json
- package-lock.json
- package.json
- src/index.mjs
- test/contract.mjs
Исходный код
# date-fns Business Day Calculations and Weekend Navigation
## What search_known_solution Answered
`search_known_solution` returned existing published samples:
- `sha256:ab08efd4bb62dbdbd02c9cfbd6a6a24927747d96b3d1c03b6f213e2cc2f25803` (Configuring global options with `setDefaultOptions`, locale objects, and ISO-8601 calendar week rules)
- `sha256:28014ee4878c4a6179543aeb40be286f2fec5b0e12c81ffa3d3401ee61d0e695` (Silent behavioral changes in duration unit omission and inverted interval normalization)
- `sha256:a1e32f3065b3b0e44599204ba5b642b93c644dcb8cdb711aac4614a58615fa61` (Custom format parsing with mandatory `referenceDate`, interval boundary exclusivity, and 24-hour differences)
Searching for business day calculations returned `NO_SAFE_MATCH`. This sample provides verified contracts for `differenceInBusinessDays`, `addBusinessDays`, `subBusinessDays`, `isWeekend`, and `eachWeekendOfInterval`.
## Exact Release Pinned
- `date-fns@4.4.0` pinned in `package.json` and `package-lock.json`.
## Observed Behaviour
1. **Weekend-to-Monday vs. Friday-to-Weekend spans**:
- `differenceInBusinessDays(Monday, Saturday)` and `differenceInBusinessDays(Monday, Sunday)` evaluate to `0`. `date-fns` counts completed business days elapsed within the interval; because Saturday and Sunday are non-working days and Monday is the exact end boundary, no full business day interval has elapsed.
- Conversely, `differenceInBusinessDays(Saturday, Friday)` and `differenceInBusinessDays(Sunday, Friday)` return `1` because the interval includes the active business day Friday.
- `differenceInBusinessDays(Monday, Friday)` returns `1` business day (Friday), skipping Saturday and Sunday.
- Signed direction is preserved: `differenceInBusinessDays(Friday, Monday)` returns `-1`.
2. **Weekend zero-step addition (`addBusinessDays(date, 0)`)**:
- Passing `0` to `addBusinessDays(sat, 0)` does not snap or normalize the weekend date to the next business day (Monday); it leaves the date on Saturday.
- Passing positive increments like `addBusinessDays(sat, 1)` and `addBusinessDays(sun, 1)` jumps to Monday.
- Decrementing via `subBusinessDays(sat, 1)` and `subBusinessDays(sun, 1)` rewinds to Friday.
3. **Inverted intervals in `eachWeekendOfInterval`**:
- In `date-fns` v4, inverted intervals (`{ start: Tuesday, end: Friday }`) return weekend dates sorted in reverse chronological order (`[Sunday, Saturday]`) rather than throwing a `RangeError`.
## Failure Mode
A model expecting `differenceInBusinessDays(Monday, Saturday)` to return `1` or `addBusinessDays(Saturday, 0)` to snap to Monday fails silently with a green build, producing off-by-one errors in business SLA calculations and leaving unexpected weekend timestamps in scheduled tasks.
{"case":{"believed":"differenceInBusinessDays from a weekend start to Monday returns 1 business day, and adding zero business days normalizes a weekend date to the next business day","caseId":"case:sha256:13474a636734d9ac5f085deac4c8407abe3b228d5a1f572698a2a83080eab907","contract":["differenceInBusinessDays from Saturday or Sunday to Monday returns 0 because no full business day elapsed, whereas Friday to Saturday returns 1","differenceInBusinessDays from Friday to Monday returns 1 business day, skipping the intervening weekend","differenceInBusinessDays preserves signed negative values when earlier date is compared to later date","addBusinessDays on Saturday with amount 0 preserves the Saturday date instead of advancing to Monday","addBusinessDays advances weekend dates to Monday for positive amounts and subBusinessDays decrements to Friday for negative steps","isWeekend identifies Saturday and Sunday while returning false for Monday through Friday","eachWeekendOfInterval returns descending weekend dates for inverted intervals without throwing RangeError"],"goal":"Calculate business day spans across weekend boundaries, advance or decrement business days, and list interval weekends with date-fns","kind":"HOW","packages":["pkg:npm/date-fns@4.4.0"],"schemaVersion":1,"symbols":["differenceInBusinessDays","addBusinessDays","subBusinessDays","isWeekend","eachWeekendOfInterval"]},"contractCommand":["node","test/contract.mjs"],"environment":{"arch":"x64","ecosystem":"npm","executionContext":"node","language":"node","os":"linux","packageManager":"npm","runtime":"node","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/date-fns@4.4.0"],"schemaVersion":1,"symbols":["differenceInBusinessDays","addBusinessDays","subBusinessDays","isWeekend","eachWeekendOfInterval"],"verifierAdapter":"node-typescript@1"}
{
"name": "npm-date-fns-v4",
"version": "1.0.0",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "npm-date-fns-v4",
"version": "1.0.0",
"dependencies": {
"date-fns": "4.4.0"
}
},
"node_modules/date-fns": {
"version": "4.4.0",
"resolved": "https://registry.npmjs.org/date-fns/-/date-fns-4.4.0.tgz",
"integrity": "sha512-+1UMbeh68lH1SegH83CGWwpb6OHHbpSgr3+s5Eww5M4CAgswBpoWS0AjTOfEJ33HiYKz1hdj/KTFprzXHmq/6w==",
"license": "MIT",
"funding": {
"type": "github",
"url": "https://github.com/sponsors/kossnocorp"
}
}
}
}
{
"name": "npm-date-fns-v4",
"version": "1.0.0",
"private": true,
"type": "module",
"dependencies": {
"date-fns": "4.4.0"
}
}
import {
differenceInBusinessDays,
addBusinessDays,
subBusinessDays,
isWeekend,
eachWeekendOfInterval,
} from 'date-fns';
/**
* Calculates the number of business days between two dates.
* Weekends (Saturday and Sunday) are excluded from the count.
*/
export function getBusinessDaysDifference(laterDate, earlierDate) {
return differenceInBusinessDays(laterDate, earlierDate);
}
/**
* Advances a date by a given number of business days, skipping weekends.
*/
export function advanceBusinessDays(date, amount) {
return addBusinessDays(date, amount);
}
/**
* Rewinds a date by a given number of business days, skipping weekends.
*/
export function rewindBusinessDays(date, amount) {
return subBusinessDays(date, amount);
}
/**
* Checks if a date falls on a weekend (Saturday or Sunday).
*/
export function checkIsWeekend(date) {
return isWeekend(date);
}
/**
* Returns all weekend dates (Saturdays and Sundays) within an interval.
*/
export function getWeekendsInInterval(start, end) {
return eachWeekendOfInterval({ start, end });
}
import { strict as assert } from 'node:assert';
import {
getBusinessDaysDifference,
advanceBusinessDays,
rewindBusinessDays,
checkIsWeekend,
getWeekendsInInterval,
} from '../src/index.mjs';
// Setup reference dates:
// 2026-08-14 is Friday
// 2026-08-15 is Saturday
// 2026-08-16 is Sunday
// 2026-08-17 is Monday
// 2026-08-18 is Tuesday
// 2026-08-21 is Friday (next week)
const fri = new Date(2026, 7, 14, 12, 0);
const sat = new Date(2026, 7, 15, 12, 0);
const sun = new Date(2026, 7, 16, 12, 0);
const mon = new Date(2026, 7, 17, 12, 0);
const tue = new Date(2026, 7, 18, 12, 0);
const nextFri = new Date(2026, 7, 21, 12, 0);
// 1. differenceInBusinessDays across weekend boundaries
// Saturday/Sunday to Monday is 0 business days because neither Saturday nor Sunday is a business day
assert.equal(getBusinessDaysDifference(mon, sat), 0);
assert.equal(getBusinessDaysDifference(mon, sun), 0);
// Saturday to Sunday is 0 business days
assert.equal(getBusinessDaysDifference(sun, sat), 0);
// Friday to Saturday or Sunday is 1 business day because Friday was an active business day
assert.equal(getBusinessDaysDifference(sat, fri), 1);
assert.equal(getBusinessDaysDifference(sun, fri), 1);
// 2. differenceInBusinessDays between business days across weekends
// Friday to Monday spans 1 completed business day (Friday)
assert.equal(getBusinessDaysDifference(mon, fri), 1);
// Saturday to Tuesday spans 1 completed business day (Monday)
assert.equal(getBusinessDaysDifference(tue, sat), 1);
// Friday to next Friday spans 5 business days
assert.equal(getBusinessDaysDifference(nextFri, fri), 5);
// 3. Signed direction: earlier date compared to later date produces negative difference
assert.equal(getBusinessDaysDifference(fri, mon), -1);
assert.equal(getBusinessDaysDifference(fri, nextFri), -5);
// 4. addBusinessDays with amount 0 does NOT snap weekend dates to Monday
const satZero = advanceBusinessDays(sat, 0);
assert.equal(satZero.getDay(), 6, 'addBusinessDays(sat, 0) preserves Saturday');
assert.equal(satZero.getDate(), 15);
const sunZero = advanceBusinessDays(sun, 0);
assert.equal(sunZero.getDay(), 0, 'addBusinessDays(sun, 0) preserves Sunday');
assert.equal(sunZero.getDate(), 16);
// 5. addBusinessDays and rewindBusinessDays skip weekends
// Adding 1 business day to Saturday or Sunday advances to Monday
const satPlus1 = advanceBusinessDays(sat, 1);
assert.equal(satPlus1.getDay(), 1, 'Saturday + 1 business day is Monday');
assert.equal(satPlus1.getDate(), 17);
const sunPlus1 = advanceBusinessDays(sun, 1);
assert.equal(sunPlus1.getDay(), 1, 'Sunday + 1 business day is Monday');
assert.equal(sunPlus1.getDate(), 17);
// Adding 1 business day to Friday advances to Monday
const friPlus1 = advanceBusinessDays(fri, 1);
assert.equal(friPlus1.getDay(), 1, 'Friday + 1 business day is Monday');
assert.equal(friPlus1.getDate(), 17);
// Subtracting 1 business day from Saturday or Sunday rewinds to Friday
const satMinus1 = rewindBusinessDays(sat, 1);
assert.equal(satMinus1.getDay(), 5, 'Saturday - 1 business day is Friday');
assert.equal(satMinus1.getDate(), 14);
const sunMinus1 = rewindBusinessDays(sun, 1);
assert.equal(sunMinus1.getDay(), 5, 'Sunday - 1 business day is Friday');
assert.equal(sunMinus1.getDate(), 14);
// Subtracting 1 business day from Monday rewinds to Friday
const monMinus1 = rewindBusinessDays(mon, 1);
assert.equal(monMinus1.getDay(), 5, 'Monday - 1 business day is Friday');
assert.equal(monMinus1.getDate(), 14);
// 6. isWeekend detection
assert.equal(checkIsWeekend(sat), true);
assert.equal(checkIsWeekend(sun), true);
assert.equal(checkIsWeekend(fri), false);
assert.equal(checkIsWeekend(mon), false);
// 7. eachWeekendOfInterval extracts all Saturdays and Sundays
const weekendList = getWeekendsInInterval(fri, tue);
assert.equal(weekendList.length, 2);
assert.equal(weekendList[0].getDay(), 6);
assert.equal(weekendList[0].getDate(), 15);
assert.equal(weekendList[1].getDay(), 0);
assert.equal(weekendList[1].getDate(), 16);
// Inverted interval returns descending sorted weekend dates in v4 without throwing RangeError
const invertedList = getWeekendsInInterval(tue, fri);
assert.equal(invertedList.length, 2);
assert.equal(invertedList[0].getDate(), 16);
assert.equal(invertedList[1].getDate(), 15);
assert.equal(invertedList[0].getTime() > invertedList[1].getTime(), true);
console.log('CONTRACT PASS: date-fns v4 business days calculations, weekend navigation, and interval weekends verified');