網(wǎng)站建設-ASP時(shí)間函數詳解大全
...
ASP時(shí)間函數詳解
Date 函數
描述:返回當前系統日期。
語(yǔ)法:Date
DateAdd 函數
描述:返回已添加指定時(shí)間間隔的日期。
語(yǔ)法:DateAdd(interval, number, date)
interval: 必選。字符串表達式,表示要添加的時(shí)間間隔。有關(guān)數值,請參閱“設置”部分。
number: 必選。數值表達式,表示要添加的時(shí)間間隔的個(gè)數。數值表達式可以是正數(得到未來(lái)的日期)或負數(得到過(guò)去的日期)。
date: 必選。Variant 或要添加 interval 的表示日期的文字。
interval 參數可以有以下值:
yyyy (年) 、q (季度) 、m (月) 、y (一年的日數) 、d (日) 、w (一周的日數) 、ww (周) 、h (小時(shí)) 、n (分鐘) 、s (秒)
說(shuō)明:可用 DateAdd 函數從日期中添加或減去指定時(shí)間間隔。例如可以使用 DateAdd 從當天算起 30 天以后的日期或從現在算起 45 分鐘以后的時(shí)間。要向 date 添加以“日”為單位的時(shí)間間隔,可以使用“一年的日數”(“y”)、“日”(“d”)或“一周的日數”(“w”)。
DateAdd 函數不會(huì )返回無(wú)效日期。如下示例將 95 年 1 月 31 日加上一個(gè)月:
NewDate = DateAdd("m", 1, "31-Jan-95")
在這個(gè)例子中,DateAdd 返回 95 年 2 月 28 日,而不是 95 年 2 月 31 日。如果 date 為 96 年 1 月 31 日,則返回 96 年 2 月 29 日,這是因為 1996 是閏年。
如果計算的日期是在公元 100 年之前則會(huì )產(chǎn)生錯誤。
如果 number 不是 Long 型值,則在計算前四舍五入為最接近的整數。
DateDiff 函數
描述:返回兩個(gè)日期之間的時(shí)間間隔。
語(yǔ)法:DateDiff(interval, date1, date2 [,firstdayofweek[, firstweekofyear>)
interval: 必選。字符串表達式,表示用于計算 date1 和 date2 之間的時(shí)間間隔。有關(guān)數值,請參閱“設置”部分。
date1, date2: 必選。日期表達式。用于計算的兩個(gè)日期。
firstdayofweek: 可選。指定星期中第一天的常數。如果沒(méi)有指定,則默認為星期日。有關(guān)數值,請參閱“設置”部分。
firstweekofyear: 可選。指定一年中第一周的常數。如果沒(méi)有指定,則默認為 1 月 1 日所在的星期。有關(guān)數值,請參閱“設置”部分。
interval 參數可以有以下值:
yyyy (年) 、q (季度) 、m (月) 、y (一年的日數) 、d (日) 、w (一周的日數) 、ww (周) 、h (小時(shí)) 、n (分鐘) 、s (秒)
firstdayofweek 參數可以有以下值:
(以下分別為:常數 值 描述)
vbUseSystem 0 使用區域語(yǔ)言支持 (NLS) API 設置。
vbSunday 1 星期日(默認)
vbMonday 2 星期一
vbTuesday 3 星期二
vbWednesday 4 星期三
vbThursday 5 星期四
vbFriday 6 星期五
vbSaturday 7 星期六
firstweekofyear 參數可以有以下值:
(以下分別為:常數 值 描述)
vbUseSystem 0 使用區域語(yǔ)言支持 (NLS) API 設置。
vbFirstJan1 1 由 1 月 1 日所在的星期開(kāi)始(默認)。
vbFirstFourDays 2 由在新年中至少有四天的第一周開(kāi)始。
vbFirstFullWeek 3 由在新的一年中第一個(gè)完整的周開(kāi)始。
說(shuō)明:DateDiff 函數用于判斷在兩個(gè)日期之間存在的指定時(shí)間間隔的數目。例如可以使用 DateDiff 計算兩個(gè)日期相差的天數,或者當天到當年最后一天之間的星期數。
要計算 date1 和 date2 相差的天數,可以使用“一年的日數”(“y”)或“日”(“d”)。當 interval 為“一周的日數”(“w”)時(shí),DateDiff 返回兩個(gè)日期之間的星期數。如果 date1 是星期一,則 DateDiff 計算到 date2 之前星期一的數目。此結果包含 date2 而不包含 date1。如果 interval 是“周”(“ww”),則 DateDiff 函數返回日歷表中兩個(gè)日期之間的星期數。函數計算 date1 和 date2 之間星期日的數目。如果 date2 是星期日,DateDiff 將計算 date2,但即使 date1 是星期日,也不會(huì )計算 date1。
如果 date1 晚于 date2,則 DateDiff 函數返回負數。
firstdayofweek 參數會(huì )對使用“w”和“ww”間隔符號的計算產(chǎn)生影響。
如果 date1 或 date2 是日期文字,則指定的年度會(huì )成為日期的固定部分。但是如果 date1 或 date2 被包括在引號 (" ") 中并且省略年份,則在代碼中每次計算 date1 或 date2 表達式時(shí),將插入當前年份。這樣就可以編寫(xiě)適用于不同年份的程序代碼。
在 interval 為“年”(“yyyy”)時(shí),比較 12 月 31 日和來(lái)年的 1 月 1 日,雖然實(shí)際上只相差一天,DateDiff 返回 1 表示相差一個(gè)年份。
DatePart 函數
描述:返回給定日期的指定部分。
語(yǔ)法:DatePart(interval, date[, firstdayofweek[, firstweekofyear>)
DatePart: 函數的語(yǔ)法有以下參數:
interval: 必選。字符串表達式,表示要返回的時(shí)間間隔。有關(guān)數值,請參閱“設置”部分。
date: 必選。要計算的日期表達式。
firstdayof week: 可選。指定星期中的第一天的常數。如果沒(méi)有指定,則默認為星期日。有關(guān)數值,請參閱“設置”部分。
firstweekofyear: 可選。指定一年中第一周的常數。如果沒(méi)有指定,則默認為 1 月 1 日所在的星期。有關(guān)數值,請參閱“設置”部分。
interval 參數可以有以下值:
yyyy (年) 、q (季度) 、m (月) 、y (一年的日數) 、d (日) 、w (一周的日數) 、ww (周) 、h (小時(shí)) 、n (分鐘) 、s (秒)
firstdayofweek 參數可以有以下值:
(以下分別為:常數 值 描述)
vbUseSystem 0 使用區域語(yǔ)言支持 (NLS) API 設置。
vbSunday 1 星期日(默認)
vbMonday 2 星期一
vbTuesday 3 星期二
vbWednesday 4 星期三
vbThursday 5 星期四
vbFriday 6 星期五
vbSaturday 7 星期六
firstweekofyear 參數可以有以下值:
(以下分別為:常數 值 描述)
vbUseSystem 0 使用區域語(yǔ)言支持 (NLS) API 設置。
vbFirstJan1 1 由 1 月 1 日所在的星期開(kāi)始(默認)。
vbFirstFourDays 2 由在新年中至少有四天的第一周開(kāi)始。
vbFirstFullWeek 3 由在新的一年中第一個(gè)完整的周(不跨年度)開(kāi)始。
說(shuō)明:DatePart 函數用于計算日期并返回指定的時(shí)間間隔。例如使用 DatePart 計算某一天是星期幾或當前的時(shí)間。
firstdayofweek 參數會(huì )影響使用“w”和“ww”間隔符號的計算。
如果 date 是日期文字,則指定的年度會(huì )成為日期的固定部分。但是如果 date 被包含在引號 (" ") 中,并且省略年份,則在代碼中每次計算 date 表達式時(shí),將插入當前年份。這樣就可以編寫(xiě)適用于不同年份的程序代碼。
DateSerial 函數
描述:對于指定的年、月、日,返回 Date 子類(lèi)型的 Variant。
語(yǔ)法:DateSerial(year, month, day)
year: 從 100 到 9999 之間的數字或數值表達式。
month: 任意數值表達式。
day: 任意數值表達式。
說(shuō)明:要指定日期,如 1991 年 12 月 31 日,DateSerial 函數中每個(gè)參數的取值范圍都應該是可接受的;即日的取值應在 1 和 31 之間,月的取值應在 1 和 12 之間。但是,也可以使用表示某日之前或之后的年、月、日數目的數值表達式為每個(gè)參數指定相對日期。
以下樣例中使用了數值表達式代替絕對日期。在這里,DateSerial 函數返回 1990 年 8 月 1 日之前十年 (1990 - 10) 零兩個(gè)月 (8 - 2) 又一天 (1 - 1) 的日期:即 1980 年 5 月 31 日。
DateSerial(1990 - 10, 8 - 2, 1 - 1)
對于 year 參數,若取值范圍是從 0 到 99,則被解釋為 1900 到 1999 年。對于此范圍之外的 year 參數,則使用四位數字表示年份(例如 1800 年)。
當任何一個(gè)參數的取值超出可接受的范圍時(shí),則會(huì )適當地進(jìn)位到下一個(gè)較大的時(shí)間單位。例如,如果指定了 35 天,則這個(gè)天數被解釋成一個(gè)月加上多出來(lái)的日數,多出來(lái)的日數取決于其年份和月份。但是如果參數值超出 -32,768 到 32,767 的范圍,或者由三個(gè)參數指定(無(wú)論是直接還是通過(guò)表達式指定)的日期超出了可以接受的日期范圍,就會(huì )發(fā)生錯誤。
DateValue 函數
描述:返回 Date 子類(lèi)型的 Variant。
語(yǔ)法:DateValue(date)
date 參數應是字符串表達式,表示從 100 年 1 月 1 日到 9999 年 12 月 31 日中的一個(gè)日期。但是,date 也可以是表示上述范圍內的日期、時(shí)間或日期時(shí)間混合的任意表達式。
說(shuō)明:如果 date 參數包含時(shí)間信息,則 DateValue 不會(huì )返回時(shí)間信息。但是如果 date 包含無(wú)效的時(shí)間信息(如 "89:98"),就會(huì )出現錯誤。
如果 date 是某一字符串,其中僅包含由有效的日期分隔符分隔開(kāi)的數字,則 DateValue 將會(huì )根據為系統指定的短日期格式識別月、日和年的順序。DateValue 還會(huì )識別包含月份名稱(chēng)(無(wú)論是全名還是縮寫(xiě))的明確日期。例如,除了能夠識別 12/30/1991 和 12/30/91 之外,DateValue 還能識別 December 30, 1991 和 Dec 30, 1991。
如果省略了 date 的年份部分,DateValue 將使用計算機系統日期中的當前年份。
Day 函數
描述:返回 1 到 31 之間的一個(gè)整數(包括 1 和31),代表某月中的一天。
語(yǔ)法:Day(date)
date 參數是任意可以代表日期的表達式。如果 date 參數中包含 Null,則返回 Null。
FormatDateTime 函數
描述:返回表達式,此表達式已被格式化為日期或時(shí)間。
語(yǔ)法:FormatDateTime(Date[,NamedFormat])
Date: 必選。要被格式化的日期表達式。
NamedFormat: 可選。指示所使用的日期/時(shí)間格式的數值,如果省略,則使用 vbGeneralDate。
NamedFormat 參數可以有以下值:
(以下分別為:常數 值 描述)
vbGeneralDate 0 顯示日期和/或時(shí)間。如果有日期部分,則將該部分顯示為短日期格式。如果有時(shí)間部分,則將該部分顯示為長(cháng)時(shí)間格式。如果都存在,則顯示所有部分。
vbLongDate 1 使用計算機區域設置中指定的長(cháng)日期格式顯示日期。
vbShortDate 2 使用計算機區域設置中指定的短日期格式顯示日期。
vbLongTime 3 使用計算機區域設置中指定的時(shí)間格式顯示時(shí)間。
vbShortTime 4 使用 24 小時(shí)格式 (hh:mm) 顯示時(shí)間。
Hour 函數
描述:返回 0 到 23 之間的一個(gè)整數(包括 0 和 23),代表一天中的某一小時(shí)。
語(yǔ)法:Hour(time)
time 參數是任意可以代表時(shí)間的表達式。如果 time 參數中包含 Null,則返回 Null。
Minute 函數
描述:返回 0 到 59 之間的一個(gè)整數(包括 0 和59),代表一小時(shí)內的某一分鐘。
語(yǔ)法:Minute(time)
time 參數是任意可以代表時(shí)間的表達式。如果 time 參數包含 Null,則返回 Null。
Month 函數
描述:返回 1 到 12 之間的一個(gè)整數(包括 1 和 12),代表一年中的某月。
語(yǔ)法:Month(date)
date 參數是任意可以代表日期的表達式。如果 date 參數中包含 Null,則返回 Null。
MonthName 函數
描述:返回表明指定月份的字符串。
語(yǔ)法:MonthName(month[, abbreviate])
month: 必選。月份的數值定義。例如,一月是 1,二月是 2,以此類(lèi)推。
abbreviate: 可選。Boolean 值,表明月份名稱(chēng)是否簡(jiǎn)寫(xiě)。如果省略,默認值為 False,即不簡(jiǎn)寫(xiě)月份名稱(chēng)。
Now 函數
描述:根據計算機系統設定的日期和時(shí)間返回當前的日期和時(shí)間值。
語(yǔ)法:Now
Second 函數
描述:返回 0 到 59 之間的一個(gè)整數(包括 1 和 59),代表一分鐘內的某一秒。
語(yǔ)法:Second(time)
time 參數是任意可以代表時(shí)間的表達式。如果 time 參數中包含 Null,則返回 Null。
Time 函數
描述:返回 Date 子類(lèi)型 Variant,指示當前系統時(shí)間。
語(yǔ)法:Time
TimeSerial 函數
描述:返回一個(gè) Date 子類(lèi)型的 Variant,含有指定時(shí)、分、秒的時(shí)間。
語(yǔ)法:TimeSerial(hour, minute, second)
hour: 其值為從 0 (12:00 A.M.) 到 23 (11:00 P.M.) 的數值或數值表達式。
minute: 任意數值表達式。
second: 任意數值表達式。
說(shuō)明:要指定一時(shí)刻,如 11:59:59,TimeSerial 的參數取值應在可接受的范圍內;也就是說(shuō),小時(shí)應介于 0-23 之間,分和秒應介于 0-59 之間。但是,可以使用數值表達式為每個(gè)參數指定相對時(shí)間,這一表達式代表某時(shí)刻之前或之后的時(shí)、分或秒數。以下樣例中使用了表達式代替絕對時(shí)間數。TimeSerial 函數返回中午之前六小時(shí) (12 - 6) 十五分鐘的時(shí)間 (-15),即 5:45:00 A.M.。
TimeSerial(12 - 6, -15, 0)
當任何一個(gè)參數的取值超出可接受的范圍時(shí),它會(huì )正確地進(jìn)位到下一個(gè)較大的時(shí)間單位中。例如,如果指定了 75 分鐘,則這個(gè)時(shí)間被解釋成一小時(shí)十五分鐘。但是,如果任何一個(gè)參數值超出 -32768 到 32767 的范圍,就會(huì )導致錯誤。如果使用三個(gè)參數直接指定的時(shí)間或通過(guò)表達式計算出的時(shí)間超出可接受的日期范圍,也會(huì )導致錯誤。
TimeValue 函數
描述:返回包含時(shí)間的 Date 子類(lèi)型的 Variant。
語(yǔ)法:TimeValue(time)
time 參數通常是代表從 0:00:00 (12:00:00 A.M.) 到 23:59:59 (11:59:59 P.M.) 的字符串表達式(包括 0:00:00 和 23:59:59)。不過(guò),time 也可以是代表該范圍內任何時(shí)間的表達式。如果 time 參數包含 Null,則返回 Null。
說(shuō)明:可以采用 12 或 24 小時(shí)時(shí)鐘格式輸入時(shí)間。例如 "2:24PM" 和 "14:24" 都是有效的 time 參數。
如果 time 參數包含日期信息, TimeValue 函數并不返回日期信息。然而,如果 time 參數包含無(wú)效的日期信息,則會(huì )出現錯誤。
Weekday 函數
描述:返回代表一星期中某天的整數。
語(yǔ)法:Weekday(date, [firstdayofweek])
date: 可以代表日期的任意表達式。如果 date 參數中包含 Null,則返回 Null。
firstdayofweek: 指定星期中第一天的常數。如果省略,默認使用 vbSunday。
firstdayofweek 參數有如下設置:
(以下分別為:常數 值 描述)
vbUseSystem 0 使用區域語(yǔ)言支持 (NLS) API 設置。
vbSunday 1 星期日
vbMonday 2 星期一
vbTuesday 3 星期二
vbWednesday 4 星期三
vbThursday 5 星期四
vbFriday 6 星期五
vbSaturday 7 星期六
Weekday 函數返回如下值:
(以下分別為:常數 值 描述)
vbSunday 1 星期日
vbMonday 2 星期一
vbTuesday 3 星期二
vbWednesday 4 星期三
vbThursday 5 星期四
vbFriday 6 星期五
vbSaturday 7 星期六
WeekdayName 函數
描述:返回一個(gè)字符串,表示星期中指定的某一天。
語(yǔ)法:WeekDayName(weekday, abbreviate, firstdayofweek)
weekday: 必選。星期中某天的數值定義。各天的數值定義取決于 firstdayofweek 參數設置。
abbreviate: 可選。Boolean 值,指明是否縮寫(xiě)表示星期各天的名稱(chēng)。如果省略, 默認值為 False,即不縮寫(xiě)星期各天的名稱(chēng)。
firstdayofweek: 可選。指明星期第一天的數值。關(guān)于數值,請參閱“設置”部分。
firstdayofweek 參數有以下值:
(以下分別為:常數 值 描述)
vbUseSystem 0 使用區域語(yǔ)言支持 (NLS) API 設置。
vbSunday 1 星期日(默認)
vbMonday 2 星期一
vbTuesday 3 星期二
vbWednesday 4 星期三
vbThursday 5 星期四
vbFriday 6 星期五
vbSaturday 7 星期六
Year 函數
描述:返回一個(gè)代表某年的整數。
語(yǔ)法:Year(date)
date 參數是任意可以代表日期的參數。如果 date 參數中包含 Null,則返回 Null。
DateDiff("n", CDate("1998-8-3 5:30"), CDate("1999-4-3 6:5"))
這里第一個(gè)參數是時(shí)間間隔,"n"表示分鐘。也可以取其他單位,最小單位為秒。
可以使用DateDiff()函數。如:
DateDiff("d", BeginDate, EndDate)。
DateDiff函數實(shí)際是用BeginDate - EndDate,如果EndDate > BeginDate,DateDiff返回負數。DateDiff可以計算按日、時(shí)等單位計算時(shí)間差。
本文轉自-山東人在北京 客城-:http://www.kecity.com/ShowPost.asp?ThreadID=6110
下一條:ASP字符串函數大全