ASP中的時間函數大全 時間操作函數第1/2頁

Date 函數
描述:返回當前系統日期。
文法:Date

DateAdd 函數
描述:返回已添加指定時間間隔的日期。
文法:DateAdd(interval, number, date)
interval: 必選。字串運算式，表示要添加的時間間隔。有關數值，請參閱“設定”部分。
number: 必選。數值運算式，表示要添加的時間間隔的個數。數值運算式可以是正數（得到未來的日期）或負數（得到過去的日期）。
date: 必選。Variant 或要添加 interval 的表示日期的文字。
interval 參數可以有以下值：
yyyy (年) 、q (季度) 、m (月) 、y (一年的日數) 、d (日) 、w (一周的日數) 、ww (周) 、h (小時) 、n (分鐘) 、s (秒)
說明:可用 DateAdd 函數從日期中添加或減去指定時間間隔。例如可以使用 DateAdd 從當天算起 30 天以後的日期或從現在算起 45 分鐘以後的時間。要向 date 添加以“日”為單位的時間間隔，可以使用“一年的日數”（“y”）、“日”（“d”）或“一周的日數”（“w”）。
DateAdd 函數不會返回無效日期。如下樣本將 95 年 1 月 31 日加上一個月：
NewDate = DateAdd("m", 1, "31-Jan-95")
在這個例子中，DateAdd 返回 95 年 2 月 28 日，而不是 95 年 2 月 31 日。如果 date 為 96 年 1 月 31 日，則返回 96 年 2 月 29 日，這是因為 1996 是閏年。
如果計算的日期是在公元 100 年之前則會產生錯誤。
如果 number 不是 Long 型值，則在計算前四捨五入為最接近的整數。

DateDiff 函數
描述:返回兩個日期之間的時間間隔。
文法:DateDiff(interval, date1, date2 [,firstdayofweek[, firstweekofyear>)
interval: 必選。字串運算式，表示用於計算 date1 和 date2 之間的時間間隔。有關數值，請參閱“設定”部分。
date1, date2: 必選。日期運算式。用於計算的兩個日期。
firstdayofweek: 可選。指定星期中第一天的常數。如果沒有指定，則預設為星期日。有關數值，請參閱“設定”部分。
firstweekofyear: 可選。指定一年中第一周的常數。如果沒有指定，則預設為 1 月 1 日所在的星期。有關數值，請參閱“設定”部分。
interval 參數可以有以下值：
yyyy (年) 、q (季度) 、m (月) 、y (一年的日數) 、d (日) 、w (一周的日數) 、ww (周) 、h (小時) 、n (分鐘) 、s (秒)
firstdayofweek 參數可以有以下值：
(以下分別為：常數 值 描述)
vbUseSystem 0 使用國家語言支援 (NLS) API 設定。
vbSunday 1 星期日（預設）
vbMonday 2 星期一
vbTuesday 3 星期二
vbWednesday 4 星期三
vbThursday 5 星期四
vbFriday 6 星期五
vbSaturday 7 星期六
firstweekofyear 參數可以有以下值：
(以下分別為：常數 值 描述)
vbUseSystem 0 使用國家語言支援 (NLS) API 設定。
vbFirstJan1 1 由 1 月 1 日所在的星期開始（預設）。
vbFirstFourDays 2 由在新年中至少有四天的第一周開始。
vbFirstFullWeek 3 由在新的一年中第一個完整的周開始。
說明:DateDiff 函數用於判斷在兩個日期之間存在的指定時間間隔的數目。例如可以使用 DateDiff 計算兩個日期相差的天數，或者當天到當年最後一天之間的星期數。
要計算 date1 和 date2 相差的天數，可以使用“一年的日數”（“y”）或“日”（“d”）。當 interval 為“一周的日數”（“w”）時，DateDiff 返回兩個日期之間的星期數。如果 date1 是星期一，則 DateDiff 計算到 date2 之前星期一的數目。此結果包含 date2 而不包含 date1。如果 interval 是“周”（“ww”），則 DateDiff 函數返回日曆表中兩個日期之間的星期數。Function Compute date1 和 date2 之間星期日的數目。如果 date2 是星期日，DateDiff 將計算 date2，但即使 date1 是星期日，也不會計算 date1。
如果 date1 晚於 date2，則 DateDiff 函數返回負數。
firstdayofweek 參數會對使用“w”和“ww”間隔符號的計算產生影響。
如果 date1 或 date2 是日期文字，則指定的年度會成為日期的固定部分。但是如果 date1 或 date2 被包括在引號 (" ") 中並且省略年份，則在代碼中每次計算 date1 或 date2 運算式時，將插入當前年份。這樣就可以編寫適用於不同年份的程式碼。
在 interval 為“年”（“yyyy”）時，比較 12 月 31 日和來年的 1 月 1 日，雖然實際上只相差一天，DateDiff 返回 1 表示相差一個年份。

DatePart 函數
描述:返回給定日期的指定部分。
文法:DatePart(interval, date[, firstdayofweek[, firstweekofyear>)
DatePart: 函數的文法有以下參數：
interval: 必選。字串運算式，表示要返回的時間間隔。有關數值，請參閱“設定”部分。
date: 必選。要計算的日期運算式。
firstdayof week: 可選。指定星期中的第一天的常數。如果沒有指定，則預設為星期日。有關數值，請參閱“設定”部分。
firstweekofyear: 可選。指定一年中第一周的常數。如果沒有指定，則預設為 1 月 1 日所在的星期。有關數值，請參閱“設定”部分。
interval 參數可以有以下值：
yyyy (年) 、q (季度) 、m (月) 、y (一年的日數) 、d (日) 、w (一周的日數) 、ww (周) 、h (小時) 、n (分鐘) 、s (秒)
firstdayofweek 參數可以有以下值：
(以下分別為：常數 值 描述)
vbUseSystem 0 使用國家語言支援 (NLS) API 設定。
vbSunday 1 星期日（預設）
vbMonday 2 星期一
vbTuesday 3 星期二
vbWednesday 4 星期三
vbThursday 5 星期四
vbFriday 6 星期五
vbSaturday 7 星期六
firstweekofyear 參數可以有以下值：
(以下分別為：常數 值 描述)
vbUseSystem 0 使用國家語言支援 (NLS) API 設定。
vbFirstJan1 1 由 1 月 1 日所在的星期開始（預設）。
vbFirstFourDays 2 由在新年中至少有四天的第一周開始。
vbFirstFullWeek 3 由在新的一年中第一個完整的周（不跨年度）開始。
說明:DatePart 函數用於計算日期並返回指定的時間間隔。例如使用 DatePart 計算某一天是星期幾或當前的時間。
firstdayofweek 參數會影響使用“w”和“ww”間隔符號的計算。
如果 date 是日期文字，則指定的年度會成為日期的固定部分。但是如果 date 被包含在引號 (" ") 中，並且省略年份，則在代碼中每次計算 date 運算式時，將插入當前年份。這樣就可以編寫適用於不同年份的程式碼。

DateSerial 函數
描述:對於指定的年、月、日，返回 Date 子類型的 Variant。
文法:DateSerial(year, month, day)
year: 從 100 到 9999 之間的數字或數值運算式。
month: 任意數值運算式。
day: 任意數值運算式。
說明:要指定日期，如 1991 年 12 月 31 日，DateSerial 函數中每個參數的取值範圍都應該是可接受的；即日的取值應在 1 和 31 之間，月的取值應在 1 和 12 之間。但是，也可以使用表示某日之前或之後的年、月、日數目的數值運算式為每個參數指定相對日期。
以下範例中使用了數值運算式代替絕對日期。在這裡，DateSerial 函數返回 1990 年 8 月 1 日之前十年 (1990 - 10) 零兩個月 (8 - 2) 又一天 (1 - 1) 的日期：即 1980 年 5 月 31 日。
DateSerial(1990 - 10, 8 - 2, 1 - 1)
對於 year 參數，若取值範圍是從 0 到 99，則被解釋為 1900 到 1999 年。對於此範圍之外的 year 參數，則使用四位元字表示年份（例如 1800 年）。
當任何一個參數的取值超出可接受的範圍時，則會適當地進位到下一個較大的時間單位。例如，如果指定了 35 天，則這個天數被解釋成一個月加上多出來的日數，多出來的日數取決於其年份和月份。但是如果參數值超出 -32,768 到 32,767 的範圍，或者由三個參數指定（無論是直接還是通過運算式指定）的日期超出了可以接受的日期範圍，就會發生錯誤。