Локализованные недели

В разных странах неделя начинается по-разному. В большинстве европейских стран первым днём недели считается понедельник, а в США — воскресенье. Кроме того, различается правило определения первой недели года.

Библиотека Moment.js учитывает региональные настройки и предоставляет отдельный набор методов для работы с локализованными неделями.

Основные задачи локализованных недель:

определение номера недели по локали;
вычисление начала и конца недели;
изменение номера недели;
поддержка календарных стандартов разных стран;
корректная работа с международными приложениями.

Метод `week()`

Метод week() возвращает номер недели года в соответствии с текущей локалью.

const moment = require('moment');

const date = moment('2025-01-10');

console.log(date.week());

Результат зависит от активной локали.

Установка локали

Для корректной работы локализованных недель необходимо установить локаль.

moment.locale('ru');

После установки русской локали неделя будет начинаться с понедельника.

Для американской локали:

moment.locale('en');

В этом случае неделя начинается с воскресенья.

Различия между `week()` и `isoWeek()`

Moment.js поддерживает два разных стандарта недель:

Метод	Стандарт
`week()`	локализованные недели
`isoWeek()`	ISO 8601

Стандарт ISO всегда использует:

понедельник как первый день недели;
первую неделю года как неделю с первым четвергом.

Пример:

const date = moment('2025-01-01');

console.log(date.week());
console.log(date.isoWeek());

В зависимости от локали результаты могут различаться.

Получение начала недели

Метод startOf('week') возвращает начало недели по локали.

const now = moment();

console.log(now.startOf('week').format('YYYY-MM-DD'));

Для русской локали результатом будет понедельник.

Для американской — воскресенье.

Получение конца недели

Метод endOf('week') возвращает последний момент недели.

const now = moment();

console.log(
    now.endOf('week').format('YYYY-MM-DD HH:mm:ss')
);

Пример различий локалей

moment.locale('ru');

console.log(
    moment('2025-03-05')
        .startOf('week')
        .format('dddd')
);

moment.locale('en');

console.log(
    moment('2025-03-05')
        .startOf('week')
        .format('dddd')
);

Результат:

понедельник
Sunday

Изменение номера недели

Метод week(number) позволяет установить неделю года.

const date = moment();

date.week(20);

console.log(date.format('YYYY-MM-DD'));

Moment автоматически пересчитает дату.

Получение года недели

Иногда неделя относится к другому году.

Например:

1 января может относиться к последней неделе предыдущего года;
31 декабря — к первой неделе следующего года.

Для получения года локализованной недели используется метод weekYear().

const date = moment('2021-01-01');

console.log(date.weekYear());

ISO-год недели

Для ISO-стандарта существует отдельный метод:

console.log(
    moment('2021-01-01').isoWeekYear()
);

Настройка параметров недели

Moment.js позволяет изменять правила вычисления недель.

Используется метод updateLocale().

Параметр `dow`

dow — первый день недели.

Значение	День
0	воскресенье
1	понедельник
6	суббота

Пример:

moment.updateLocale('custom', {
    week: {
        dow: 1
    }
});

moment.locale('custom');

Параметр `doy`

doy определяет правило первой недели года.

Например:

moment.updateLocale('custom', {
    week: {
        dow: 1,
        doy: 4
    }
});

Здесь:

неделя начинается в понедельник;
первая неделя должна содержать 4 января.

Это соответствует ISO 8601.

Проверка параметров локали

Получение текущих настроек:

console.log(
    moment.localeData()._week
);

Результат:

{
    dow: 1,
    doy: 4
}

Практический пример календаря

moment.locale('ru');

const current = moment();

const start = current.clone().startOf('week');

for (let i = 0; i < 7; i++) {
    console.log(
        start.clone()
            .add(i, 'days')
            .format('dddd DD.MM.YYYY')
    );
}