DATEPART (SSIS)
傳回的整數代表日期的日期部分。
語法
DATEPART(datepart, date)
引數
datepart
這是指定日期中哪一個部分要傳回新值的參數。date
傳回有效日期或日期格式字串的運算式。
結果類型
DT_I4
備註
如果引數為 Null，則 DATEPART 會傳回 Null 結果。
日期常值必須明確轉換為日期資料類型之一。如需詳細資訊，請參閱＜Integration Services 資料類型＞。
[!附註]
當日期常值明確轉換成以下其中一個日期資料類型時，此運算式將會驗證失敗：DT_DBTIMESTAMPOFFSET、DT_DBTIMESTAMP2 和 DT_DBTIME2。
下表列出運算式評估工具所辨識的日期部分與縮寫。日期部分的名稱不區分大小寫。
日期部分 |
縮寫 |
|---|---|
年份 |
yy, yyyy |
季度 |
qq, q |
月份 |
mm, m |
年中的日 |
dy, y |
日 |
dd, d |
週 |
wk, ww |
工作日 |
dw, w |
小時 |
Hh |
分鐘 |
mi, n |
秒 |
ss, s |
毫秒數 |
Ms |
範例
這個範例會傳回在日期常值中代表月份的整數。如果日期格式為 mm/dd/yyyy"，則這個範例會傳回 11。
DATEPART("month", (DT_DBTIMESTAMP)"11/04/2002")
這個範例會傳回 ModifiedDate 資料行中，代表天的整數。
DATEPART("dd", ModifiedDate)
這個範例會傳回代表目前日期之年份的整數。
DATEPART("yy",GETDATE())