Модуль y5.Dates

Функции для работы с датами

Требует загрузки модуля Dates.

changeMonth

y5.Dates.changeMonth(date, shift) -> Date — Измененная дата

Меняет месяц.
Если месяц имеет 31 день, а новый 30, то дата будет установлена в 30-е число.

Имя аргументаТипОписание
dateDateДата
shiftNumberСмещение

changeYear

y5.Dates.changeYear(date, shift) -> Date — Измененная дата

Меняет год.
Если месяц имеет 31 день, а новый 30, то дата будет установлена в 30-е число.

Имя аргументаТипОписание
dateDateДата
shiftNumberСмещение

dayNames

y5.Dates.dayNames -> array

Однобуквенное название дней недели (П, В, С, Ч, П, С, В)

dayNames2

y5.Dates.dayNames2 -> array

Двухбуквенное название дней недели (Пн, Вт, Ср, Чт, Пт, Сб, Вс)

days

y5.Dates.days -> object

Дни недели

getDayOffset

y5.Dates.getDayOffset(currentDay, firstDay) -> Number

Возвращает разницу между firstDay и currentDay.
Также может использоваться для вычисления какой день недели currentDay, если первый firstDay.

Имя аргументаТипОписание
currentDayNumber, StringТекущий день
firstDayNumber, StringПервый день недели

Пример:

y5.Dates.getDayOffset('Sunday', 'Monday')
// -> 6

getMonthDays

y5.Dates.getMonthDays(month, year) -> Number

Получить количество дней в месяце

Имя аргументаТипОписание
monthNumber, DateНомер месяца (0..11) или объект Date
yearNumberгод. Указывается только вместе с номером месяца

Пример:

y5.Dates.getMonthDays(1, 2008);
// -> 29

monthNames

y5.Dates.monthNames -> array

Полное название месяцев ("Январь" ... "Декабрь")

monthNamesPartitive

y5.Dates.monthNamesPartitive -> array

Полное название месяцев в родительном падеже ("января" ... "декабря")

monthShortNames

y5.Dates.monthShortNames -> array

Трехбуквенное название месяцев ('Янв ... Дек')

strToTime

y5.Dates.strToTime(string) -> Date, NaN — Дата или NaN

Преобразует текстовое представление даты в объект Date. При ошибке преобразования вернет NaN

Имя аргументаТипОписание
stringStringТекстовое представление даты

toFormat

y5.Dates.toFormat(date, dateFormat) -> String — результат обработки

Форматировует дату согласно формату.
Формат передается в виде "%Y.%m.%d %H:%M:%S".
Y - год (4 цифры)
y - год (2 цифры)
m - месяц (2 цифры)
n - месяц без лидирующего нуля
B - месяц (полное имя, например, Январь)
b - месяц (короткое имя, например, Янв)
d - день месяца (2 цифры)
e - день месяца без лидирующего нуля
H - часы (2 цифры от 00 до 23)
M - минуты (2 цифры)
S - секунды (2 цифры)
Внимание: шаблон "%e %B" преобразует вернет имя месяца в родительном падеже.

Имя аргументаТипОписание
dateDateДата
dateFormatStringФормат

getDay

Устарело, используйте y5.Dates.getDayOffset.

y5.Dates.getDay()