Date 物件
啟用日期和時間之基本儲存和擷取功能的物件。 Date 建構函式 (Constructor) 有兩種形式。
function Date( [dateVal : { Number | String | System.DateTime } ] )
function Date( year : int, month : int, date : int[, hours : int [, minutes : int [, seconds : int [, ms : int]]]] )
引數
dateVal
選擇項。 如果數值 dateVal 表示指定日期和 1970 年 1 月 1 日午夜之間的國際標準時間毫秒數字。 如果根據 方法中的值剖析 dateVal。 dateVal 也可以是 .NET 日期值。year
必要項。 代表完整年份,例如 1976 (非 76)。month
必要項。 代表月份,以 0 到 11 之間的整數表示一月到十二月。date
必要項。 代表日期,以介於 1 到 31 之間的整數表示。hours
選擇項。 如果指定 minutes 的話,就必須指定這一項。 以介於 0 到 23 之間的整數 (表示午夜到下午 11 點) 來指定小時。minutes
選擇項。 如果指定 seconds 的話,就必須指定這一項。 以介於 0 到 59 之間的整數來指定分鐘。seconds
選擇項。 如果指定 milliseconds 的話,就必須指定這一項。 以介於 0 到 59 之間的整數來指定秒數。ms
選擇項。 以介於 0 到 999 之間的整數來指定毫秒數。
備註
Date 物件包含代表以毫秒表示的某個時間的數字。 如果引數值大於其範圍或者是負數的話,其他的儲存值都會跟著修改。 例如,您若指定 150 秒,JScript 就會重新將該數字定義為 2 分 30 秒。
如果數字是 NaN,則該物件不能代表某個時間。 如果您沒有傳遞參數給 Date 建構函式,它會初始化為目前的時間 (UTC)。 Date 型別的變數必須在使用之前先初始化。
Date 物件中可以表示的日期範圍大約是 1970 年 1 月 1 日加減 285,616 年。
Date 物件具有兩個呼叫時不需要建立 Date 物件的靜態 (Static) 方法,即 parse 和 UTC。
如果呼叫 Date 建構函式時沒有使用 new 運算子,無論傳入建構函式的引數為何,傳回的 Date 物件都會包含目前日期。
注意事項 |
---|
Date 物件在 JScript 中可以與 .NET Framework System.DateTime 資料型別交互操作。 但是其他 Common Language Specification (CLS) 語言無法使用 Date 物件,因為只有 JScript 提供這個物件;它不是繼承自 .NET Framework 型別。 因此,當您為 CLS 相容方法的參數和傳回型別加註型別時,請確定您使用的是 System.DateTime 資料型別而非 Date 物件。 但是,您可以使用 Date 物件,為參數或傳回型別 (Return Type) 以外的識別項加註型別。 如需詳細資訊,請參閱撰寫符合 CLS 標準的程式碼。 |
如需如何使用 Date 物件和相關方法的詳細資訊,請參閱日期及時間計算。
範例
下列範例使用 Date 物件。
var s : String = "Today's date is: "; // Declare variables.
var d : Date = new Date(); // Create Date object with today's date.
s += (d.getMonth() + 1) + "/"; // Get month
s += d.getDate() + "/"; // Get day
s += d.getYear(); // Get year.
print(s); // Print date.
如果這個程式是在 1992 年 1 月 26 日執行,輸出的結果會是:
Today's date is: 1/26/1992