Date オブジェクト

[アーティクル]
08/09/2011

このオブジェクトを使用して、日付と時刻を格納したり、取得したりできます。 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
省略可能です。数値で指定する場合、dateVal は、指定した日付と 1970 年 1 月 1 日午前 00:00:00 との間を、ミリ秒単位の数値を使って世界協定時刻で表します。文字列で指定する場合、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 準拠コードの記述」を参照してください。

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