setFullYear (Date.setFullYear メソッド)

public setFullYear(year: Number , [month: Number ], [date: Number ]) : Number

指定された Date オブジェクトの年をローカル時間で設定し、新しい時間をミリ秒で返します。month パラメータと date パラメータを指定すると、両方は同時にローカル時間に設定されます。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。

このメソッドを呼び出しても、指定した Date オブジェクトの他のフィールドは修正されません。ただし、このメソッドを呼び出した結果として曜日が変わった場合には、Date.getUTCDay()Date.getDay() は新しい値を返します。

対応バージョン : ActionScript 1.0、Flash Player 5

パラメータ

year:Number - 年を指定する 4 桁の数値です。2 桁の数値は 4 桁の年の省略形を表しません。たとえば、99 は 1999 年ではなく、99 年です。

month:Number (オプション) - 0 (1 月) ~ 11 (12 月) の整数です。このパラメータを省略した場合、指定した Date オブジェクトの month フィールドは変更されません。

date:Number (オプション) - 1 ~ 31 の数値です。このパラメータを省略した場合、指定した Date オブジェクトの date フィールドは変更されません。

戻り値

Number - 整数。

次の例では、日付を 2004 年 5 月 15 日に設定した新しい Date オブジェクトをまず作成した後、Date.setFullYear() を使って日付を 2002 年 5 月 15 日に変更します。

var my_date:Date = new Date(2004,4,15);
trace(my_date.getFullYear()); //output: 2004
my_date.setFullYear(2002);
trace(my_date.getFullYear()); //output: 2002

関連項目

getUTCDay (Date.getUTCDay メソッド), getDay (Date.getDay メソッド)


 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flash/9.0_jp/main/00001603.html