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

Эта функция возвращает значение True, если значение timestamp находится в пределах части года, включающей значение, заданное в поле base\_date до последней миллисекунды, указанной в поле base\_date, включительно.

Синтаксис:

InYearToDate (timestamp, base\_date, period\_no[, first\_month\_of\_year])

**Тип возврата данных:** Булево значение

Аргументы:

аргументы InYearToDate

| Аргумент | Описание |
| --- | --- |
| timestamp | Дата, которую необходимо сравнить со значением, указанным в поле base\_date. |
| base\_date | Дата, использующаяся для оценки года. |
| period\_no | Год можно сместить, задав целое число в поле period\_no. period\_no, где значение 0 указывает на год, который содержит значение base\_date. Отрицательные значения, заданные в поле period\_no, означают предшествующие годы, положительные — последующие. |
| first\_month\_of\_year | Если необходимо работать с годами (финансовыми), которые начинаются не в январе, задайте значение от 2 до 12 в поле first\_month\_of\_year. |

Пример 1:

`inyeartodate ('2013/01/25', '2013/02/01',   0)`

Возвращает True

Пример 2:

`inyeartodate ('2012/01/25', '2013/01/01',   0)`

Возвращает False

Пример 3:

`inyeartodate ('2012/01/25', '2013/02/01',   -1)`

Возвращает True

Пример 4:

`inyeartodate ('2012/11/25', '2013/01/31',   0, 4)`

Возвращает True  
Значение timestamp выпадает на финансовый год, начинающийся в четвертом месяце, и до значения base\_date.

Пример 5:

`inyeartodate ( '2013/3/31', '2013/01/31',   0, 4 )`

Возвращает False  
По сравнению с предыдущим примером, значение timestamp все еще находится в фискальном году, но после значения base\_date, таким образом, оно находится за пределами части года.

Пример 6:

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

В этом примере проверяется, выпадает ли дата счета на финансовый год, указанный путем указания значения 4 для элемента first\_month\_of\_year, и на часть года до окончания 31/01/2013.

`TempTable:` `LOAD RecNo() as InvID, * Inline [` `InvDate` `28/03/2012` `10/12/2012` `5/2/2013` `31/3/2013` `19/5/2013` `15/9/2013` `11/12/2013` `2/3/2014` `14/5/2014` `13/6/2014` `7/7/2014` `4/8/2014` `];` ` ` `InvoiceData:` `LOAD *,` `InYearToDate(InvDate, '31/01/2013', 0, 4) AS FinYr2Date` `Resident TempTable;`

`Drop table TempTable;`

Результирующая таблица содержит исходные даты и столбец с возвращенным значением функции inyeartodate().

Результаты примера 6

| InvDate | FinYr2Date |
| --- | --- |
| 28/03/2012 | 0 (False) |
| 10/12/2012 | -1 (True) |
| 5/2/2013 | 0 (False) |
| 31/3/2013 | 0 (False) |
| 19/5/2013 | 0 (False) |
| 15/9/2013 | 0 (False) |
| 11/12/2013 | 0 (False) |
| 2/3/2014 | 0 (False) |
| 14/5/2014 | 0 (False) |
| 13/6/2014 | 0 (False) |
| 7/7/2014 | 0 (False) |
| 4/8/2014 | 0 (False) |