Функции для работы с датами
Требует загрузки модуля Dates.
changeMonth
y5.Dates.changeMonth(date, shift) -> Date — Измененная дата
Меняет месяц.
Если месяц имеет 31 день, а новый 30, то дата будет установлена в 30-е число.
Имя аргумента | Тип | Описание |
---|---|---|
date | Date | Дата |
shift | Number | Смещение |
changeYear
y5.Dates.changeYear(date, shift) -> Date — Измененная дата
Меняет год.
Если месяц имеет 31 день, а новый 30, то дата будет установлена в 30-е число.
Имя аргумента | Тип | Описание |
---|---|---|
date | Date | Дата |
shift | Number | Смещение |
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.
Имя аргумента | Тип | Описание |
---|---|---|
currentDay | Number, String | Текущий день |
firstDay | Number, String | Первый день недели |
Пример:
y5.Dates.getDayOffset('Sunday', 'Monday') // -> 6
getMonthDays
y5.Dates.getMonthDays(month, year) -> Number
Получить количество дней в месяце
Имя аргумента | Тип | Описание |
---|---|---|
month | Number, Date | Номер месяца (0..11) или объект Date |
year | Number | год. Указывается только вместе с номером месяца |
Пример:
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
Имя аргумента | Тип | Описание |
---|---|---|
string | String | Текстовое представление даты |
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" преобразует вернет имя месяца в родительном падеже.
Имя аргумента | Тип | Описание |
---|---|---|
date | Date | Дата |
dateFormat | String | Формат |