Эта функция возвращает значение метки времени, соответствующее началу первого дня года, содержащего значение, указанное в поле date. По умолчанию для вывода используется формат DateFormat, установленный в скрипте.
Синтаксис:
YearStart(date[, period_no[, first_month_of_year]])
Тип возврата данных: двойное значение
Аргументы:
| Аргумент | Описание |
|---|---|
| date | Дата для вычисления. |
| period_no | period_no — целое число, где 0 обозначает год, включающий значение, указанное в поле date. Отрицательные значения, заданные в поле period_no, означают предшествующие годы, положительные — последующие. |
| first_month_of_year | Если необходимо работать с годами (финансовыми), которые начинаются не в январе, задайте значение от 2 до 12 в поле first_month_of_year. |
Примеры и результаты:
В этих примерах используется формат даты DD/ММ/YYYY. Формат даты указан в операторе SET DateFormat в верхней части скрипта загрузки. Измените формат в примерах согласно своим пожеланиям.
Пример 1:
yearstart ('19/10/2001')
Возвращает 01/01/2001.
Пример 2:
yearstart ('19/10/2001', -1)
Возвращает 01/01/2000.
Пример 3:
yearstart ('19/10/2001', 0, 4)
Возвращает 01/04/2001.
Пример 4:
Добавьте образец скрипта в свой документ и запустите. Затем добавьте на лист документа как минимум поля, указанные в столбце с результатами, чтобы увидеть результаты.
В этом примере выполняется обнаружение первого дня в году каждой даты счета в таблице, где первый месяц в году указан как месяц 4.
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 *,
YearStart(InvDate, 0, 4) AS YrStart
Resident TempTable;
Drop table TempTable;
Результирующая таблица содержит исходные даты и столбец с возвращенным значением функции yearstart(). Чтобы отобразить полную метку времени, укажите форматирование в свойствах диаграммы.
| InvDate | YrStart |
|---|---|
| 28/03/2012 | 01/04/2011 |
| 10/12/2012 | 01/04/2012 |
| 5/2/2013 | 01/04/2012 |
| 31/3/2013 | 01/04/2012 |
| 19/5/2013 | 01/04/2013 |
| 15/9/2013 | 01/04/2013 |
| 11/12/2013 | 01/04/2013 |
| 2/3/2014 | 01/04/2013 |
| 14/5/2014 | 01/04/2014 |
| 13/6/2014 | 01/04/2014 |
| 7/7/2014 | 01/04/2014 |
| 4/8/2014 | 01/04/2014 |
