Date オブジェクト

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

このオブジェクトを使用して、日付と時刻を格納したり、取得したりできます。Date コンストラクタには、次の 2 つの形式があります。

function Date( [dateVal : { Number | String | System.DateTime } ] )
function Date( year : int, month : int, date : int[, hours : int [, minutes : int [, seconds : int [, ms : int]]]] )

引数

dateVal
省略可能です。数値で指定する場合は、指定した日付と 1970 年 1 月 1 日 0 時 0 分 0 秒との間を、ミリ秒単位の数値を使って世界協定時刻 (UTC) で表します。文字列で指定する場合は、dateVal は parse メソッドでの規則に準じて解析されます。dateVal は、.NET データ値でも指定できます。
year
必ず指定します。4 桁の年 (76 ではなく 1976 など)。
month
必ず指定します。月を表す 0 ～ 11 (1 ～ 12 月に相当) の範囲内の整数を指定します。
date
必ず指定します。日を表す 1 ～ 31 の範囲内の整数を指定します。
hours
省略可能です。引数 minutes を指定する場合は、この引数を指定する必要があります。時を表す 0 ～ 23 (午前 0 時～午後 11 時に対応) の範囲内の整数を指定します。
minutes
省略可能です。引数 seconds を指定する場合は、この引数を指定する必要があります。分を表す 0 ～ 59 の範囲内の整数を指定します。
seconds
省略可能です。引数 milliseconds を指定する場合は、この引数を指定する必要があります。秒を表す 0 ～ 59 の範囲内の整数を指定します。
ms
省略可能です。ミリ秒を表す 0 ～ 999 の範囲内の整数を指定します。

解説

Date オブジェクトには、特定の時刻をミリ秒で表す数値が格納されます。引数に有効範囲を超える値や負の値を指定すると、値に応じて格納される他の値が変更されます。たとえば、150 秒を指定すると、2 分 30 秒として処理されます。

格納されている数値が NaN の場合は、オブジェクトが特定の時刻を表していないことを示します。Date コンストラクタに渡すパラメータがない場合は、現在の時刻 (UTC) で初期化されます。Date 型の変数は、使用する前に初期化する必要があります。

Date オブジェクトで表せる日付の範囲は、1970 年 1 月 1 日の前後の約 285,616 年です。

Date オブジェクトには、Date オブジェクトを作成しなくても呼び出すことができる、parse と UTC の 2 つの静的なメソッドがあります。

Date コンストラクタが new 演算子を使用せずに呼び出されると、コンストラクタに渡される引数にかかわらず、返される Date オブジェクトには現在の日付が含まれます。

メモ :
JScript 内では、Date オブジェクトは .NET Framework の System.DateTime データ型と相互運用されます。ただし、Date オブジェクトがサポートされるのは JScript だけです。このオブジェクトは .NET Framework 型から派生していないため、他の共通言語仕様 (CLS: Common Language Specification) 言語では使用できません。したがって、CLS 準拠のメソッドのパラメータと戻り値の型を型の注釈で指定する場合は、Date オブジェクトではなく System.DateTime 型を使用してください。ただし、パラメータや戻り値の型以外の識別子では、Date オブジェクトを使用して型の注釈を指定できます。詳細については、「CLS 準拠コードの記述」を参照してください。

JScript 内では、Date オブジェクトは .NET Framework の System.DateTime データ型と相互運用されます。ただし、Date オブジェクトがサポートされるのは JScript だけです。このオブジェクトは .NET Framework 型から派生していないため、他の共通言語仕様 (CLS: Common Language Specification) 言語では使用できません。したがって、CLS 準拠のメソッドのパラメータと戻り値の型を型の注釈で指定する場合は、Date オブジェクトではなく System.DateTime 型を使用してください。ただし、パラメータや戻り値の型以外の識別子では、Date オブジェクトを使用して型の注釈を指定できます。詳細については、「CLS 準拠コードの記述」を参照してください。

使用例

次の例では、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 日に実行すると、出力は次のようになります。