說明
DatePart 會傳回一個數字,指定已知日期的指定部分。
多載
DatePart (間隔類型, 輸入日期時間, 每週的第一天)
DatePart (間隔類型, 輸入日期時間, 每週的第一天, 每年的第一週)
引數
間隔類型引數是一個字串運算式,指定日期即將傳回的部分。
每週的第一天引數是選擇性的常數,用來指定每週的第一天。如果不指定,就假設是 crSunday。
每年的第一週引數是選擇性的常數,指定每年的第一週。如果未指定,就會將一月一日那一週當成第一週 (crFirstJan1)。
引數值
IntervalType 值可以是下列其中一種︰
| |
|---|
| |
| |
| |
| 每年的第幾天 (1 到 365,閏年則是 366)
|
| |
| 每星期的第幾天 (1 到 7,結果依據每週的第一天而定)
|
| 每年的第幾週 (1 到 53,並且由每週的第一天與每年的第一週決定每年第一個日曆週確實是哪幾天)
|
| |
| |
| |
動作
DatePart 會傳回一個數字,指定已知日期的指定部分。
範例
DatePart ("d", #August 15, 1999#)傳回 15。
DatePart ("m", #August 15, 1999#)傳回 8。
DatePart ("n", #10:35 am#)傳回 35。
DatePart ("q", #September 29, 1999#)傳回 3,因為 9 月 29 日是當年第三季。
DatePart ("ww", #September 14, 1997#)傳回 38,因為 1997 年 9 月 14 日是 1997 年的第 38 週。
假設某公司要將每批貨物印上識別號碼,做為品質管制之用。這個識別碼是訂貨編號後面接著破折號,後面接著訂單裝運的星期,再接著年份的後兩碼。以下公式範例就可以產生這種識別碼:
CStr({Orders.Order ID}, 0, "") & "-" &
CStr(DatePart("ww", {Orders.Ship Date}), 0) &
CStr({Orders.Ship Date}, "yy")
如果 {訂貨主檔.訂貨編號} 是 2082,而且 {訂貨主檔.送貨日期} 是 1997 年 9 月 14 日,傳回字串 "2082-3897"。
註解
DatePart 函式配合 "yyyy" 間隔類型引數等於是 Year 函式。同樣地,DatePart 函式配合 "m"、"d"、"w"、"h"、"n" 與 "s" 間隔類型引數分別等於是 Month、Day、Weekday (或 DayOfWeek)、Hour、Minute 與 Second 函式。在另一方面,使用 DatePart 函式與 "q"、"y" 與 "ww" 間隔類型引數則沒有簡單的替代方法。
當間隔類型引數是 "w" 或 "ww" 時,每週的第一天引數會影響 DatePart 函式。至於所有其他的間隔類型引數值則會忽略這個引數。
唯有當間隔類型引數是 "ww" 時,每年的第一週引數才會影響 DatePart 函式。至於所有其他的間隔類型引數值則會忽略這個引數。