yeartodate — скрипт и функция диаграммы

Эта функция определяет, находится ли введенная дата в том году, в котором находится дата последней загрузки скрипта, и возвращает значение True, если это так, и False если это не так.

Syntax:  

YearToDate(timestamp [ , yearoffset [ , firstmonth [ , todaydate] ] ])

 

Тип возврата данных: Boolean

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

Arguments:  

Аргумент Описание
timestamp Дата для вычисления в виде метки времени или выражения, определяемого по метке времени, для преобразования, например '2012-10-12'.
yearoffset

При указании элемента yearoffset, элемент yeartodate возвращает значение True для того же периода в другом году. Отрицательный элемент yearoffset указывает предыдущий год, положительное смещение — будущий год. Наиболее поздняя дата с начала года до последнего момента достигается путем указания yearoffset = -1. Если значение не указано, принимается 0.

firstmonth

Если в поле firstmonth задать значение от 1 до 12 (1, если значение не указано), то начало года может быть передвинуто вперед на первый день любого месяца. Если, например, необходимо работать в рамках финансового года, начинающегося 1 мая, задайте firstmonth = 5.

todaydate Задав значение todaydate (метка времени последнего выполнения скрипта, если не указано), можно сместить день, используемый в качестве верхней границы периода.