Как узнать номер недели по дате в формате YYYY-MM-DD

Введите дату в формате YYYY-MM-DD, чтобы получить её номер календарной недели ISO и связанные календарные сведения. Если дата не указана, используется текущая дата, поэтому для повторяемого результата задайте её явно.

Что рассчитывает инструмент

Номер недели помогает привязать дату к календарному плану, отчёту, расписанию или сроку выполнения задачи. Инструмент Week Number принимает дату в формате YYYY-MM-DD и рассчитывает для неё номер календарной недели ISO. Вместе с номером можно получить дополнительные сведения о календаре: ISO-календарный год, данные о дне недели, количество недель в году, представление недели и календарный квартал. Такой способ удобен, когда нужно проверить дату без ручного подсчёта и сохранить единый формат ввода.

Дата должна быть записана с четырьмя цифрами года, двумя цифрами месяца и двумя цифрами дня, например 2024-06-15. Формат важен: запись вроде 15.06.2024 не относится к предусмотренному строковому формату. Если вы работаете не со строкой, дату можно задать тремя числовыми значениями: годом, месяцем и днём. Этот вариант подходит для формы или другого сценария, где календарные компоненты вводятся отдельно.

Как узнать номер недели

Откройте инструмент Week Number и выберите способ задания даты: одной строкой или отдельными числовыми полями.
При вводе строкой укажите дату в формате YYYY-MM-DD. Например, для 15 июня 2024 года введите 2024-06-15. Не меняйте порядок частей даты и не заменяйте дефисы точками или косыми чертами.
Если используются отдельные поля, заполните год, месяц и день числовыми значениями. Компонентный способ срабатывает, когда переданы все три значения. Проверьте, что ни одна из частей не пропущена и что значения описывают существующую дату.
Если одновременно заполнены строка даты и поля года, месяца и дня, приоритет получает непустая строка даты. Поэтому перед расчётом проверьте именно её: значения в отдельных полях не заменят введённую строку.
Запустите расчёт и просмотрите возвращённые сведения. Для корректной даты инструмент выдаёт номер календарной недели ISO, а также доступные календарные детали. Номер недели относится к диапазону от 1 до 53; количество недель в соответствующем году указывается как 52 или 53.
Если явная дата некорректна, исправьте исходное значение и повторите расчёт. Ошибка передаётся в данных результата, при этом сама операция может быть отмечена как успешная. Поэтому одного признака успешного выполнения недостаточно: нужно прочитать содержимое результата и убедиться, что там нет сообщения об ошибке.
Если не указана непустая строка даты и не переданы все три компонента, инструмент использует текущую дату. Такой результат нельзя трактовать как постоянное значение: при повторном обращении в другое время номер может измениться. Если нужна воспроизводимая проверка, задайте явную дату.

Как читать результат

Главное поле результата - номер календарной недели ISO для выбранной корректной даты. Диапазон 1-53 не означает, что в каждом году присутствует 53-я неделя: число недель года отдельно указывается как 52 или 53. Поэтому при планировании сравнивайте номер недели с календарным годом, который также возвращается в дополнительных сведениях. Это особенно важно на границе года, когда дата в конце декабря или начале января может относиться к ISO-календарному году, отличному от обычного календарного представления даты.

Дополнительные данные помогают проверить результат в контексте. День недели показывает положение даты внутри недели, представление недели даёт ещё одну форму чтения результата, а квартал связывает дату с более крупным периодом года. Если эти поля нужны для отчёта, переносите их вместе с исходной датой, чтобы не потерять контекст расчёта.

Результат для текущей даты следует считать временным: без явного ввода инструмент каждый раз ориентируется на текущий день. Кроме того, способ обработки часового пояса для такого автоматического выбора даты не определён, поэтому для документа, сверки или повторяемого расчёта лучше вводить дату вручную.

Проверка на конкретной дате выглядит так: введите 2024-01-01 и запустите расчёт. Для этой даты возвращается номер недели 1. В ответе также присутствуют календарные сведения, предусмотренные для корректной даты, включая данные об ISO-календарном годе, дне недели, количестве недель в году, представлении недели и квартале. Если вместо этого появляется сообщение об ошибке, сначала проверьте формат и существование введённой даты.

Практический пример

Вам нужно проверить, к какой календарной неделе ISO относится 1 января 2024 года.

Введите 2024-01-01 в поле даты и запустите расчёт. Затем проверьте номер недели и остальные поля календарных сведений.

Для даты 2024-01-01 результат содержит номер недели 1 и календарные сведения, включая ISO-календарный год, данные о дне недели, количество недель в году, представление недели и квартал.

Ограничения

Для автоматического выбора текущей даты результат может измениться со временем, а способ учёта часового пояса в этом сценарии не определён.

Частые ошибки

Причина: дата введена не в формате YYYY-MM-DD или содержит недопустимые компоненты. Исправьте порядок частей, используйте дефисы и проверьте, что такая дата существует; затем прочитайте данные нового результата, а не только его признак успешного выполнения.

Частые вопросы

Можно ли задать дату одной строкой?

Да, но только если строка даты непустая и записана в формате YYYY-MM-DD. При одновременной передаче компонентов года, месяца и дня непустая строка имеет приоритет.

Что произойдёт, если дату не вводить?

Если непустая строка даты отсутствует и переданы не все три компонента, инструмент использует текущую дату. Поэтому значение зависит от момента обращения; для фиксированного результата укажите дату явно.

Как инструмент сообщает об ошибке в дате?

Некорректная дата передаётся в результате как сообщение об ошибке, хотя операция при этом может иметь признак успешного выполнения. Проверьте содержимое результата, исправьте дату и повторите расчёт.