js下的時間函數
Date 對象能夠使你獲得相對於國際標準時間(格林威治標準時間,現在被稱爲 UTC-Universal Coordinated Time)或者是 Flash 播放器正運行的操作系統的時間和日期。要使用Date對象的方法,你就必須先創建一個Date對象的實體(Instance)。
Date 對象必須使用 Flash 5 或以後版本的播放器。
Date 對象的方法並不是靜態的,但是在使用時卻可以應用於所指定的單獨實體。
Date 對象的方法簡介:
·getDate | 根據本地時間獲取當前日期(本月的幾號)
·getDay | 根據本地時間獲取今天是星期幾(0-Sunday,1-Monday...)
·getFullYear | 根據本地時間獲取當前年份(四位數字)
·getHours | 根據本地時間獲取當前小時數(24小時制,0-23)
·getMilliseconds | 根據本地時間獲取當前毫秒數
·getMinutes | 根據本地時間獲取當前分鐘數
·getMonth | 根據本地時間獲取當前月份(注意從0開始:0-Jan,1-Feb...)
·getSeconds | 根據本地時間獲取當前秒數
·getTime | 獲取UTC格式的從1970.1.1 0:00以來的毫秒數
·getTimezoneOffset | 獲取當前時間和UTC格式的偏移值(以分鐘爲單位)
·getUTCDate | 獲取UTC格式的當前日期(本月的幾號)
·getUTCDay | 獲取UTC格式的今天是星期幾(0-Sunday,1-Monday...)
·getUTCFullYear | 獲取UTC格式的當前年份(四位數字)
·getUTCHours | 獲取UTC格式的當前小時數(24小時制,0-23)
·getUTCMilliseconds | 獲取UTC格式的當前毫秒數
·getUTCMinutes | 獲取UTC格式的當前分鐘數
·getUTCMonth | 獲取UTC格式的當前月份(注意從0開始:0-Jan,1-Feb...)
·getUTCSeconds | 獲取UTC格式的當前秒數
·getYear | 根據本地時間獲取當前縮寫年份(當前年份減去1900)
·setDate | 設置當前日期(本月的幾號)
·setFullYear | 設置當前年份(四位數字)
·setHours | 設置當前小時數(24小時制,0-23)
·setMilliseconds | 設置當前毫秒數
·setMinutes | 設置當前分鐘數
·setMonth | 設置當前月份(注意從0開始:0-Jan,1-Feb...)
·setSeconds | 設置當前秒數
·setTime | 設置UTC格式的從1970.1.1 0:00以來的毫秒數
·setUTCDate | 設置UTC格式的當前日期(本月的幾號)
·setUTCFullYear | 設置UTC格式的當前年份(四位數字)
·setUTCHours | 設置UTC格式的當前小時數(24小時制,0-23)
·setUTCMilliseconds | 設置UTC格式的當前毫秒數
·setUTCMinutes | 設置UTC格式的當前分鐘數
·setUTCMonth | 設置UTC格式的當前月份(注意從0開始:0-Jan,1-Feb...)
·setUTCSeconds | 設置UTC格式的當前秒數
·setYear | 設置當前縮寫年份(當前年份減去1900)
·toString | 將日期時間值轉換成"日期/時間"形式的字符串值
·Date.UTC | 返回指定的UTC格式日期時間的固定時間值
創建新的 Date 對象
語法:
new Date();
new Date(year [, month [, date [, hour [, minute [, second [, millisecond ]]]]]] );
參數:
year 是一個 0 到 99 之間的整數,對應於 1900 到 1999 年,或者爲四位數字指定確定的年份;
month 是一個 0 (一月) 到 11 (十二月) 之間的整數,這個參數是可選的;
date 是一個 1 到 31 之間的整數,這個參數是可選的;
hour 是一個 0 (0:00am) 到 23 (11:00pm) 之間的整數,這個參數是可選的;
minute 是一個 0 到 59 之間的整數,這個參數是可選的;
second 是一個 0 到 59 之間的整數,這個參數是可選的;
millisecond 是一個 0 到 999 之間的整數,這個參數是可選的;
註釋:
對象。新建一個 Date 對象。
播放器支持:
Flash 5 或以後的版本。
例子:
下面是獲得當前日期和時間的例子:
now = new Date();
下面創建一個關於國慶節的 Date 對象的例子:
national_day = new Date (49, 10, 1);
下面是新建一個 Date 對象後,利用 Date 對象的 getMonth、getDate、和 getFullYear方法獲取時間,然後在動態文本框中輸出的例子。
myDate = new Date();
dateTextField = (mydate.getMonth() + "/" + myDate.getDate() + "/" + mydate.getFullYear());
Date > Date.getDate
Date.getDate
語法:myDate.getDate();
參數:無
註釋:
方法。根據本地時間獲取當前日期(本月的幾號),返回值是 1 到 31 之間的一個整數。
播放器支持:Flash 5 或以後版本。
Date > Date.getDay
Date.getDay
語法:myDate.getDay();
參數:無
註釋:
方法。根據本地時間獲取今天是星期幾(0-星期日,1-星期一...)。本地時間由 Flash 播放器所運行的操作系統決定。
播放器支持:Flash 5 或以後版本。
Date > Date.getFullYear
Date.getFullYear
語法:myDate.getFullYear();
參數:無
註釋:
方法。根據本地時間獲取當前年份(四位數字,例如 2000)。本地時間由 Flash 播放器所運行的操作系統決定。
播放器支持:Flash 5 或以後版本。
例子:
下面的例子新建了一個 Date 對象,然後在輸出窗口輸出用 getFullYear 方法獲得的年份:
myDate = new Date();
trace(myDate.getFullYear());
Date > Date.getHours
Date.getHours
語法:myDate.getHours();
參數:無
註釋:
方法。根據本地時間獲取當前小時數(24小時制,返回值爲0-23之間的整數)。本地時間由 Flash 播放器所運行的操作系統決定。
播放器支持:Flash 5 或以後版本。
Date > Date.getMilliseconds
Date.getMilliseconds
語法:myDate.getMilliseconds();
參數:無
註釋:
方法。根據本地時間獲取當前毫秒數(返回值是 0 到 999 之間的一個整數)。本地時間由 Flash 播放器所運行的操作系統決定。
播放器支持:Flash 5 或以後版本。
Date > Date.getMinutes
Date.getMinutes
語法:myDate.getMinutes();
參數:無
註釋:
方法。根據本地時間獲取當前分鐘數(返回值是 0 到 59 之間的一個整數)。本地時間由 Flash 播放器所運行的操作系統決定。
播放器支持:Flash 5 或以後版本。
Date > Date.getMonth
Date.getMonth
語法:myDate.getMonth();
參數:無
註釋:
方法。根據本地時間獲取當前月份(注意從0開始:0-一月,1-二月...)。本地時間由 Flash 播放器所運行的操作系統決定。
播放器支持:Flash 5 或以後版本。
Date > Date.getSeconds
Date.getSeconds
語法:myDate.getSeconds();
參數:無
註釋:
方法。根據本地時間獲取當前秒數(返回值是 0 到 59 之間的一個整數)。本地時間由 Flash 播放器所運行的操作系統決定。
播放器支持:Flash 5 或以後版本。
Date > Date.getTime
Date.getTime
語法:myDate.getTime();
參數:無
註釋:
方法。按UTC格式返回從1970年1月1日0:00am起到現在的毫秒數。使用這個方法可以描述不同時區裏的同一瞬間的時間。
播放器支持:Flash 5 或以後版本。
Date > Date.getTimezoneOffset
Date.getTimezoneOffset
語法:mydate.getTimezoneOffset();
參數:無
註釋:
方法。獲取當前時間和UTC格式的偏移值(以分鐘爲單位)。
播放器支持:Flash 5 或以後版本。
例子:
下面的例子將返回北京時間與UTC時間之間的偏移值。
new Date().getTimezoneOffset();
結果如下:
480 (8 小時 * 60 分鐘/小時 = 480 分鐘)
Date > Date.getUTCDate
Date.getUTCDate
語法:myDate.getUTCDate();
參數:無
註釋:
方法。獲取UTC格式的當前日期(本月的幾號)。
播放器支持:Flash 5 或以後版本。
Date > Date.getUTCDay
Date.getUTCDay
語法:myDate.getUTCDate();
參數:無
註釋:
方法。獲取UTC格式的今天是星期幾(0-星期日,1-星期一...)。
播放器支持:Flash 5 或以後版本。
Date > Date.getUTCFullYear
Date.getUTCFullYear
語法:myDate.getUTCFullYear();
參數:無
註釋:
方法。獲取UTC格式的當前年份(四位數字)。
播放器支持:Flash 5 或以後版本。
Date > Date.getUTCHours
Date.getUTCHours
語法:myDate.getUTCHours();
參數:無
註釋:
方法。獲取UTC格式的當前小時數(24小時制,返回值爲0-23之間的一個整數)。
播放器支持:Flash 5 或以後版本。
Date > Date.getUTCMilliseconds
Date.getUTCMilliseconds
語法:myDate.getUTCMilliseconds();
參數:無
註釋:
方法。獲取UTC格式的當前毫秒數(返回值是 0 到 999 之間的一個整數)。
播放器支持:Flash 5 或以後版本。
Date > Date.getUTCMinutes
Date.getUTCMinutes
語法:myDate.getUTCMinutes();
參數:無
註釋:
方法。獲取UTC格式的當前分鐘數(返回值是 0 到 59 之間的一個整數)。
播放器支持:Flash 5 或以後版本。
Date > Date.getUTCMonth
Date.getUTCMonth
語法:myDate.getUTCMonth();
參數:無
註釋:
方法。獲取UTC格式的當前月份(注意從0開始:0-一月,1-二月...)。
播放器支持:Flash 5 或以後版本。
Date > Date.getUTCSeconds
Date.getUTCSeconds
語法:myDate.getUTCSeconds();
參數:無
註釋:
方法。獲取UTC格式的當前秒數(返回值是 0 到 59 之間的一個整數)。
播放器支持:Flash 5 或以後版本。
Date > Date.getYear
Date.getYear
語法:myDate.getYear();
參數:無
註釋:
方法。根據本地時間獲取當前縮寫年份(當前年份減去1900)。本地時間由 Flash 播放器所運行的操作系統決定。例如 2000 年用100來表示。
播放器支持:Flash 5 或以後版本。
Date > Date.setDate
Date.setDate
語法:myDate.setDate(date);
參數:date 爲 1 到 31 之間的一個整數。
註釋:
方法。根據本地時間設置當前日期(本月的幾號)。本地時間由 Flash 播放器所運行的操作系統決定。
播放器支持:Flash 5 或以後版本。
Date > Date.setFullYear
Date.setFullYear
語法:myDate.setFullYear(year [, month [, date]] );
參數:
year 指定的四位整數代表指定年份,二位數字並不代表年份,如99不表示1999,只表示公元99年
month 是一個從 0 (一月) 到 11 (十二月) 之間的整數,這個參數是可選的。
date 是一個從 1 到 31 之間的整數,這個參數是可選的。
註釋:
方法。根據本地時間設定年份。如果設定了 month 和 date 參數,將同時設定月份和日期。本地時間由 Flash 播放器所運行的操作系統決定。設定之後 getUTCDay 和 getDay 方法所獲得的值將出現相應的變化。
播放器支持:Flash 5 或以後版本。
Date > Date.setHours
Date.setHours
語法:myDate.setHours(hour);
參數:hour 是一個從 0 (0:00am) 到 23 (11:00pm) 之間的整數。
註釋:
方法。根據本地時間設置當前小時數。本地時間由 Flash 播放器所運行的操作系統決定。
播放器支持:Flash 5 或以後版本。
Date > Date.setMilliseconds
Date.setMilliseconds
語法:myDate.setMilliseconds(millisecond);
參數:millisecond 是一個從 0 到 999 之間的整數。
註釋:
方法。根據本地時間設置當前毫秒數。本地時間由 Flash 播放器所運行的操作系統決定。
播放器支持:Flash 5 或以後版本。
Date > Date.setMinutes
Date.setMinutes
語法:myDate.setMinutes(minute);
參數:minute 是一個從 0 到 59 之間的整數。
註釋:
方法。根據本地時間設置當前分鐘數。本地時間由 Flash 播放器所運行的操作系統決定。
播放器支持:Flash 5 或以後版本。
Date > Date.setMonth
Date.setMonth
語法:myDate.setMonth(month [, date ]);
參數:
month 是一個從 0 (一月) 到 11 (十二月)之間的整數
date 是一個從 1 到 31 之間的整數,這個參數是可選的。
註釋:
方法。根據本地時間設置當前月份數,如果選用了 date 參數,將同時設定日期。本地時間由 Flash 播放器所運行的操作系統決定。
播放器支持:Flash 5 或以後版本。
Date > Date.setSeconds
Date.setSeconds
語法:myDate.setSeconds(second);
參數:second 是一個從 0 到 59 之間的整數。
註釋:
方法。根據本地時間設置當前秒數。本地時間由 Flash 播放器所運行的操作系統決定。
播放器支持:Flash 5 或以後版本。
Date > Date.setTime
Date.setTime
語法:myDate.setTime(millisecond);
參數:millisecond 是一個從 0 到 999 之間的整數。
註釋:
方法。用毫秒數來設定指定的日期。
播放器支持:Flash 5 或以後版本。
Date > Date.setUTCDate
Date.setUTCDate
語法:myDate.setUTCDate(date);
參數:date 是一個從 1 到 31 之間的整數。
註釋:
方法。按UTC格式設定日期,使用本方法將不會影響 Date 對象的其他字段的值,但是 getUTCDay 和 getDay 方法會返回日期更改過後相應的新值。
播放器支持:Flash 5 或以後版本。
Date > Date.setUTCFullYear
Date.setUTCFullYear
語法:myDate.setUTCFullYear(year [, month [, date]]);
參數:
year 代表年份的四位整數,如 2000
month 一個從 0 (一月) 到 11 (十二月)之間的整數,可選參數。
date 一個從 1 到 31 之間的整數,可選參數。
註釋:
方法。按UTC格式設定年份,如果使用了可選參數,還同時設定月份和日期。設定過後 getUTCDay 和 getDay 方法會返回一個相應的新值。
播放器支持:Flash 5 或以後版本。
Date > Date.setUTCHours
Date.setUTCHours
語法:myDate.setUTCHours(hour [, minute [, second [, millisecond]]]));
參數:
hour 是一個從 0 (0:00am) 到 23 (11:00pm)之間的整數。
minute 是一個從 0 到 59 之間的整數,可選參數。
second 是一個從 0 到 59 之間的整數,可選參數。
millisecond 是一個從 0 到 999 之間的整數,可選參數。
註釋:
方法。設定UTC格式的小時數,如果是用可選參數,同時會設定分鐘、秒和毫秒值。
播放器支持:Flash 5 或以後版本。
Date > Date.setUTCMilliseconds
Date.setUTCMilliseconds
語法:myDate.setUTCMilliseconds(millisecond);
參數:millisecond 是一個從 0 到 999 之間的整數。
註釋:
方法。設定UTC格式的毫秒數。
播放器支持:Flash 5 或以後版本。
Date > Date.setUTCMinutes
Date.setUTCMinutes
語法:myDate.setUTCMinutes(minute [, second [, millisecond]]));
參數:
minute 是一個從 0 到 59 之間的整數,可選參數。
second 是一個從 0 到 59 之間的整數,可選參數。
millisecond 是一個從 0 到 999 之間的整數,可選參數。
註釋:
方法。設定UTC格式的分鐘數,如果是用可選參數,同時會設定秒和毫秒值。
播放器支持:Flash 5 或以後版本。
Date > Date.setUTCMonth
Date.setUTCMonth
語法:myDate.setUTCMonth(month [, date]);
參數:
month 是一個從 0 (一月) 到 11 (十二月)之間的整數
date 是一個從 1 到 31 之間的整數,這個參數是可選的。
註釋:
方法。設定UTC格式的月份,同時可選設置日期。設定後 getUTCDay 和 getDay 方法會返回相應的新值。
播放器支持:Flash 5 或以後版本。
Date > Date.setUTCSeconds
Date.setUTCSeconds
語法:myDate.setUTCSeconds(second [, millisecond]));
參數:
second 是一個從 0 到 59 之間的整數,可選參數。
millisecond 是一個從 0 到 999 之間的整數,可選參數。
註釋:
方法。設定UTC格式的秒數,如果是用可選參數,同時會設定毫秒值。
播放器支持:Flash 5 或以後版本。
Date > Date.setYear
Date.setYear
語法:myDate.setYear(year);
參數:year 是一個代表年份的四位整數,如 2000。
註釋:
方法。根據本地時間設定年份。本地時間由 Flash 播放器所運行的操作系統決定。
播放器支持:Flash 5 或以後版本。
Date > Date.toString
Date.toString
語法:myDate.toString();
參數:無
註釋:
方法。將日期時間值轉換成"日期/時間"形式的字符串值
播放器支持:Flash 5 或以後版本。
例子:
下面的例子將國慶節的 national_day 對象輸出成可讀的字符串:
var national_day = newDate(49, 9, 1, 10, 00);
trace (national_day.toString());
Output (for Pacific Standard Time):
結果爲:Sat Oct 1 10:00:00 GMT+0800 1949
Date > Date.UTC
Date.UTC
語法:Date.UTC(year, month [, date [, hour [, minute [, second [, millisecond ]]]]]);
參數:
year 代表年份的四位整數,如 2000
month 一個從 0 (一月) 到 11 (十二月)之間的整數。
date 一個從 1 到 31 之間的整數,可選參數。
hour 是一個從 0 (0:00am) 到 23 (11:00pm)之間的整數。
minute 是一個從 0 到 59 之間的整數,可選參數。
second 是一個從 0 到 59 之間的整數,可選參數。
millisecond 是一個從 0 到 999 之間的整數,可選參數。
註釋:
方法。返回指定時間距 1970 年 1 月 1 日 0:00am 的毫秒數。這是一個靜態的方法,不需要特定的對象。它能夠創建一個新的 UTC 格式的 Date 對象,而 new Date() 所創建的是本地時間的 Date 對象。
播放器支持:Flash 5 或以後版本。