Date 物件

發行項
08/12/2011

啟用日期和時間之基本儲存和擷取功能的物件。 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 物件在 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 日執行，輸出的結果會是：