yearstart - 指令碼與圖表函數
此函數傳回的時間戳記相當於包含 date 的年份的第一天開始。預設的輸出格式為指令碼中所設定的 DateFormat。
語法：
YearStart(date[, period_no[, first_month_of_year]])
傳回的資料類型： 雙值
引數：
引數
| date
|
待評估的日期。 |
| period_no
|
period_no 為整數，其中值 0 表示是包含 date 的年份。負值的 period_no 表示之前的年度，正值表示之後的年度。 |
| first_month_of_year
|
如果要使用不起始於 1 月的 (會計) 年度，可在 first_month_of_year 中指定介於 2 和 12 之間的值。 |
這些範例使用日期格式 DD/MM/YYYY。日期格式是在位於資料載入指令碼頂端的 SET DateFormat 陳述式中指定。變更範例中的格式，以滿足您的需求。
指令碼處理範例
| yearstart ('19/10/2001')
|
傳回 01/01/2001。 |
| yearstart ('19/10/2001', -1)
|
傳回 01/01/2000。 |
| yearstart ('19/10/2001', 0, 4)
|
傳回 01/04/2001。
|
範例：
將範例指令碼新增至您的應用程式並予以執行。然後將結果資料行中列出的欄位新增至您應用程式中的工作表以查看結果。
此範例會尋找表格中每一個發票日期所在年的第一天，其中該年度的第一個月指定為月份 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 |
