setUTCFullYear (Date.setUTCFullYear メソッド)

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

指定された Date オブジェクト (my_date) の年を世界時で設定し、新しい時間をミリ秒で返します。

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

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

パラメータ

year:Number - 4 桁の年 (2000 など) を表す整数です。

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

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

戻り値

Number - 整数。

次の例では、今日の日付に設定した新しい Date オブジェクトをまず作成した後、Date.setUTCFullYear() を使って年の値を 2001 に変更し、さらに日付を 1995 年 5 月 25 日に変更します。

var my_date:Date = new Date();
my_date.setUTCFullYear(2001);
trace(my_date.getUTCFullYear()); // output: 2001
my_date.setUTCFullYear(1995, 4, 25);
trace(my_date.getUTCFullYear()); // output: 1995
trace(my_date.getUTCMonth()); // output: 4
trace(my_date.getUTCDate()); // output: 25

関連項目

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


 

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

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