| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date クラスは日時のデータを表します。Date クラスの 1 つのインスタンスは特定の一時点を表します。この特定の一時点について、月、日、時、秒などのプロパティを照会および変更できます。Date クラスを使用すると、世界時（グリニッジ標準時。現在の呼称は世界標準時または UTC）またはローカル時間を基準にした日付と時刻の値を取得できます。ローカル時間は、Flash Player を実行しているオペレーティングシステムに設定されているローカルタイムゾーンによって決定されます。Date クラスのメソッドは静的ではありません。メソッドを呼び出すときに指定した個々の Date オブジェクトにのみ適用されます。例外として、
Date.UTC() メソッドと
Date.parse() メソッドがあります。これらは静的なメソッドです。
Date クラスによる夏時間の処理方法は、オペレーティングシステムおよび Flash Player のバージョンに応じて異なります。Flash Player 6 以降では、夏時間は各オペレーティングシステムで次のように処理されます。
- Windows - Date オブジェクトの出力は夏時間に合わせて自動的に調整されます。Date オブジェクトは、夏時間が現在の地域で採用されているかどうかを確認します。夏時間が採用されている場合は、夏時間に移行する日付と時刻の基準を確認します。ただし、現在有効な夏時間の日付が過去と未来に適用されるために、夏時間の日付が異なる地域では、計算される夏時間の日付が過去の日付と食い違う場合があります。
- Mac OS X - Date オブジェクトの出力は夏時間に合わせて自動的に調整されます。Mac OS X では、タイムゾーン情報データベースを使用して、現在または過去の日付または時刻に夏時間の時差を適用する必要があるかどうかを決定します。
- Mac OS 9 - 現在の日付および時刻に夏時間の時差を適用する必要があるかどうかを判定できるだけの情報しか提供されません。したがって、Date オブジェクトは、現在の夏時間の時差が過去および将来のすべての日時に適用されると想定します。
Flash Player 5 によるオペレーティングシステム別の夏時間の対処方法は次のとおりです。
- Windows - 夏時間に関する米国の規則が常に適用されるために、米国とは夏時間に移行する時期が異なるヨーロッパおよび他の地域では移行期間が食い違います。Flash は、現在の地域で採用されている夏時間を正しく検出します。
Date クラスを使用するには、new 演算子を使用して Date インスタンスを作成します。
ActionScript 3.0 は新しいアクセサプロパティをいくつか追加しています。これらのアクセサプロパティは、Date インスタンスにアクセスしたり、Date インスタンスを変更する多くの Date クラスメソッドの代わりに使用できます。また、ActionScript 3.0 には、ECMA-262 Edition 3 に準拠するために組み込まれている、toString() メソッドの新しい変形メソッド（Date.toLocaleString()、Date.toTimeString()、Date.toLocaleTimeString()、Date.toDateString() および Date.toLocaleDateString()）も含まれます。
相対時間または経過時間を計算するには、flash.utils パッケージに含まれる getTimer() メソッドを参照してください。
例を表示
date:Number [読み書き可能]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトで指定されたローカル時間による日付（1 ～ 31 の整数）です。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。
実装 AS3 function get date():Number AS3 function set date(value:Number):void関連項目
dateUTC:Number [読み書き可能]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトの世界時（UTC）による日付（1 ～ 31 の整数）です。
実装 AS3 function get dateUTC():Number AS3 function set dateUTC(value:Number):void関連項目
day:Number [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
この Date で指定されたローカル時間による曜日（日曜日は 0、月曜日は 1 など）です。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。
実装 AS3 function get day():Number関連項目
dayUTC:Number [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
この Date の世界時（UTC）による曜日（日曜日は 0、月曜日は 1 など）です。
実装 AS3 function get dayUTC():Number関連項目
fullYear:Number [読み書き可能]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトのローカル時間による年（2000 などの 4 桁の数字）です。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。
実装 AS3 function get fullYear():Number AS3 function set fullYear(value:Number):void関連項目
fullYearUTC:Number [読み書き可能]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトの世界時（UTC）による 4 桁の年です。
実装 AS3 function get fullYearUTC():Number AS3 function set fullYearUTC(value:Number):void関連項目
hours:Number [読み書き可能]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトのローカル時間による時（0 ～ 23 の整数）部分です。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。
実装 AS3 function get hours():Number AS3 function set hours(value:Number):void関連項目
hoursUTC:Number [読み書き可能]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトの世界時（UTC）による時（0 ～ 23 の整数）です。
実装 AS3 function get hoursUTC():Number AS3 function set hoursUTC(value:Number):void関連項目
milliseconds:Number [読み書き可能]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトのローカル時間によるミリ秒（0 ～ 999 の整数）部分です。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。
実装 AS3 function get milliseconds():Number AS3 function set milliseconds(value:Number):void関連項目
millisecondsUTC:Number [読み書き可能]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトの世界時（UTC）によるミリ秒（0 ～ 999 の整数）部分です。
実装 AS3 function get millisecondsUTC():Number AS3 function set millisecondsUTC(value:Number):void関連項目
minutes:Number [読み書き可能]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトのローカル時間による分（0 ～ 59 の整数）部分です。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。
実装 AS3 function get minutes():Number AS3 function set minutes(value:Number):void関連項目
minutesUTC:Number [読み書き可能]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトの世界時（UTC）による分（0 ～ 59 の整数）部分です。
実装 AS3 function get minutesUTC():Number AS3 function set minutesUTC(value:Number):void関連項目
month:Number [読み書き可能]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトのローカル時間による月（1 月は 0、2 月は 1 など）です。 ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。
実装 AS3 function get month():Number AS3 function set month(value:Number):void関連項目
monthUTC:Number [読み書き可能]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトの世界時（UTC）による月（0（1 月）～ 11（12 月））部分です。
実装 AS3 function get monthUTC():Number AS3 function set monthUTC(value:Number):void関連項目
seconds:Number [読み書き可能]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトのローカル時間による秒（0 ～ 59 の整数）部分です。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。
実装 AS3 function get seconds():Number AS3 function set seconds(value:Number):void関連項目
secondsUTC:Number [読み書き可能]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトの世界時（UTC）による秒（0 ～ 59 の整数）部分です。
実装 AS3 function get secondsUTC():Number AS3 function set secondsUTC(value:Number):void関連項目
time:Number [読み書き可能]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトの 1970 年 1 月 1 日 0 時（世界時）からのミリ秒数です。このメソッドは、複数の Date オブジェクトを比較する際に特定の時間を表すのに使用します。
実装 AS3 function get time():Number AS3 function set time(value:Number):void関連項目
timezoneOffset:Number [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
世界時（UTC）とコンピュータのローカル時間の差（分単位）です。つまり、この分の値をコンピュータのローカル時間に加算すると世界時と等しくなります。コンピュータの時刻が世界時より遅い時間に設定されている場合、戻り値は負の数になります。
実装 AS3 function get timezoneOffset():Number関連項目
public function Date(yearOrTimevalue:Object, month:Number, date:Number = 1, hour:Number = 0, minute:Number = 0, second:Number = 0, millisecond:Number = 0)| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
指定された日時を保持する新しい Date オブジェクトを作成します。
Date() コンストラクタは、日付と、ミリ秒までの時刻を指定する、最大 7 つまでパラメータ（year、month、...、millisecond）を取ります。新しく作成された Date オブジェクトに含まれる日付は、渡された引数の数とデータ型により異なります。
- 引数が渡されなかった場合、Date オブジェクトには現在の日時が割り当てられます。
- データ型 Number の引数が 1 つ渡された場合、Date オブジェクトには、1970 年 1 月 1 日 0:00:00（GMT）からその 1 つの引数で指定されたミリ秒数後の時間値が割り当てられます。
- データ型 String の引数が 1 つ渡され、このストリングに有効な日付が含まれている場合は、Date オブジェクトにはその日付に基づく時間値が割り当てられます。
- 複数の引数が渡された場合、Date オブジェクトには、渡された引数値が表す日付の年、月、日、時、分、秒、ミリ秒に基づく時間値が割り当てられます。
Date クラスのコンストラクタにストリングを渡す場合、日付にはさまざまな形式を使用できますが、少なくとも月、日、年が含まれている必要があります。例えば、Feb 1 2005 は有効ですが、Feb 2005 は無効です。次に、有効な形式をいくつか示します。
-
曜日 月 日 時:分:秒 GMT 年（例えば「Tue Feb 1 00:00:00 GMT-0800 2005」。これは
toString() に対応します）。
-
曜日 月 日 年 時:分:秒 午前（AM） / 午後（PM）（例えば「Tue Feb 1 2005 12:00:00 AM」。これは
toLocaleString() に対応します）。
-
曜日 月 日 年（例えば「Tue Feb 1 2005」。これは
toDateString() に対応します）。
- 月/日/年（例えば "02/01/2005"）
- 月/年（例えば "02/2005"）
パラメータ | yearOrTimevalue:Object —
他のパラメータが指定されている場合、この数値は年（1965 年など）を表します。それ以外の場合は時間値を表します。数値が年を表す場合、0 ～ 99 の値は 1900 ～ 1999 を表します。それ以外の場合は年を 4 桁で指定する必要があります。数値が時間値を表す（他にパラメータが指定されない）場合は、1970 年 1 月 1 日 0:00:00 GMT を基準とする経過時間をミリ秒単位で表す値になります。負の値は 1970 年 1 月 1 日 0:00:00 GMT よりも前の時刻を表し、正の値はそれより後の時刻を表します。
|
| |
| month:Number — 0（1 月）～ 11（12 月）の整数です。 |
| |
| date:Number (default = 1) |
| |
| hour:Number (default = 0) |
| |
| minute:Number (default = 0) |
| |
| second:Number (default = 0) |
| |
| millisecond:Number (default = 0) |
関連項目
AS3 function getDate():Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトで指定された日付（1 ～ 31 の整数）をローカル時間で返します。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。
戻り値 | Number —
Date オブジェクトが表す日付（1 ～ 31）です。
|
関連項目
例
次の例では、新しい Date オブジェクト
someBirthday を作成し、パラメータに
year（
1974）、
month（
10 = 11 月）、
day（
30）、
hour（
1）、
minute（
20）を指定します。 次に、
getDate() メソッドを呼び出し、日付を取得します。
package {
import flash.display.Sprite;
public class DateExample extends Sprite {
public function DateExample() {
var someBirthday:Date = new Date(1974, 10, 30, 1, 20);
trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974
trace(someBirthday.getDate()); // 30
}
}
} AS3 function getDay():Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
この Date で指定された曜日（日曜日は 0、月曜日は 1 など）をローカル時間で返します。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。
戻り値 | Number —
Date オブジェクトが表す曜日の数値（0 ～ 6）です。
|
例
次の例では、新しい Array オブジェクト
weekDayLabels を作成して、エレメント
[Sunday,Monday,Tuesday,Wednesday,Thursday,Friday,Saturday] を設定し、次に、新しい Date オブジェクト
someBirthday を作成して、パラメータに
year（
1974）、
month（
10 = 11 月）、
day（
30）、
hour（
1）、
minute（
20）を指定します。 次に
getDay() メソッドを 2 回呼び出します。1 回目は日付を 6 という数値で表示し、2 回目は
weekDayLabels を使用して曜日を表示します。
var weekDayLabels:Array = new Array("Sunday",
"Monday",
"Tuesday",
"Wednesday",
"Thursday",
"Friday",
"Saturday");
var someBirthday:Date = new Date(1974, 10, 30, 1, 20);
trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974
trace(someBirthday.getDay()); // 6
trace(weekDayLabels[someBirthday.getDay()]); // Saturday AS3 function getFullYear():Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトの年（2000 などの 4 桁の数字）をローカル時間で返します。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。
戻り値 | Number —
Date オブジェクトが表す 4 桁の年です。
|
例
次の例では、新しい Date オブジェクト
someBirthday を作成し、パラメータに
year（
1974）、
month（
10 = 11 月）、
day（
30）、
hour（
1）、
minute（
20）を指定します。 次に、
getFullYear() メソッドを呼び出し、4 桁の年を取得します。
var someBirthday:Date = new Date(1974, 10, 30, 1, 20);
trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974
trace(someBirthday.getFullYear()); // 1974
AS3 function getHours():Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトの時（0 ～ 23 の整数）部分をローカル時間で返します。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。
戻り値 | Number —
Date オブジェクトが表す時（0 ～ 23）です。
|
例
次の例では、新しい Date オブジェクト
someBirthday を作成し、パラメータに
year（
1974）、
month（
10 = 11 月）、
day（
30）、
hour（
1）、
minute（
20）を指定します。 次に、
getHours() メソッドと
getMinutes() メソッドを呼び出し、時と分を 24 時間形式で取得します。 最後に、ストリング
localTime を作成し、関数
getUSClockTime() の呼び出し結果を割り当てます。この関数は、
getHours() と
getMinutes() を再度呼び出します。これにより、時間
03:05 PM が表示されます。
var someBirthday:Date = new Date(1974, 10, 30, 15, 5);
trace(someBirthday); // Sat Nov 30 15:20:00 GMT-0800 1974
trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 15:5
var localTime:String = getUSClockTime(someBirthday.getHours(), someBirthday.getMinutes());
trace(localTime); // 03:05 PM
function getUSClockTime(hrs:uint, mins:uint):String {
var modifier:String = "PM";
var minLabel:String = doubleDigitFormat(mins);
if(hrs > 12) {
hrs = hrs-12;
} else if(hrs == 0) {
modifier = "AM";
hrs = 12;
} else if(hrs < 12) {
modifier = "AM";
}
return (doubleDigitFormat(hrs) + ":" + minLabel + " " + modifier);
}
function doubleDigitFormat(num:uint):String {
if(num < 10) {
return ("0" + num);
}
return num;
} AS3 function getMilliseconds():Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトのミリ秒（0 ～ 999 の整数）部分をローカル時間で返します。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。
戻り値 例
次の例では、新しい Date オブジェクト
now をパラメータの指定なしで作成します。次に、
getMilliseconds() メソッドを呼び出し、Date オブジェクト
now の作成時点のミリ秒数 を取得します。
var now:Date = new Date();
trace(now.getMilliseconds());
AS3 function getMinutes():Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトの分（0 ～ 59 の整数）部分をローカル時間で返します。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。
戻り値 例
次の例では、新しい Date オブジェクト
now をパラメータの指定なしで作成します。次に、
getMinutes() メソッドを呼び出し、Date オブジェクト
now の作成時点の分を取得します。
var now:Date = new Date();
trace(now);
trace(now.getMinutes());
AS3 function getMonth():Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
この Date の月（1 月は 0、2 月は 1 など）部分をローカル時間で返します。 ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。
戻り値 | Number —
Date オブジェクトの月（0 ～ 11）部分です。
|
例
次の例では、新しい Array オブジェクト
monthLabels を作成して、
January から
December までのエレメントを設定し、次に、パラメータを指定せずに新しい Date オブジェクト
now を作成します。 次に、
getMonth() メソッドを 2 回呼び出します。1 回目は、Date オブジェクト作成時点の
now の月の数値を返し、2 回目は月の名前を返します。
var monthLabels:Array = new Array("January",
"February",
"March",
"April",
"May",
"June",
"July",
"August",
"September",
"October",
"November",
"December");
var now:Date = new Date();
trace(now.getMonth());
trace(monthLabels[now.getMonth()]); AS3 function getSeconds():Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトの秒（0 ～ 59 の整数）部分をローカル時間で返します。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。
戻り値 | Number —
Date オブジェクトの秒（0 ～ 59 の整数）部分です。
|
例
次の例では、新しい Date オブジェクト
now をパラメータの指定なしで作成します。次に、
getSeconds() メソッドを呼び出し、Date オブジェクト
now の作成時点の秒を取得します。
var now:Date = new Date();
trace(now.getSeconds());
AS3 function getTime():Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトの 1970 年 1 月 1 日 0 時（世界時）からのミリ秒数を返します。このメソッドは、複数の Date オブジェクトを比較する際に特定の時間を表すのに使用します。
戻り値 | Number —
Date オブジェクトが表す 1970 年 1 月 1 日からのミリ秒数です。
|
例
次の例では、新しい Date オブジェクト
mlk を作成し、パラメータに
year（
1929）、
month（
0 = 1 月）、
day（
15）を指定します。 次に、
getTime() メソッドを呼び出し、1970 年 1 月 1 日午前 0 時からのミリ秒数を取得します。年が 1929 に設定されているため、ミリ秒は負の値で表されます。
var mlk:Date = new Date(1929, 0, 15);
trace(mlk); // Tue Jan 15 00:00:00 GMT-0800 1929
trace(mlk.getTime()); // -1292601600000
次の例では、新しい Date オブジェクト
now をパラメータ指定なしで作成し、次に、以降で作成する DateMath クラスのメソッドを使用して、元の Date オブジェクト
now の作成時刻に時間を追加します。
-
addSeconds()：now に 30 秒を追加します。
-
addMinutes()：now に 30 分を追加します。
-
addHours()：Date オブジェクト now に 6 時間を追加します。
-
addDays()：Date オブジェクト now に 30 日を追加します。
-
addWeeks()：now に 4 週間を追加します。
var now:Date = new Date();
trace(now);
trace(DateMath.addSeconds(now, 30));
trace(DateMath.addMinutes(now, 30));
trace(DateMath.addHours(now, 6));
trace(DateMath.addDays(now, 30));
trace(DateMath.addWeeks(now, 4));
class DateMath {
public static function addWeeks(date:Date, weeks:Number):Date {
return addDays(date, weeks*7);
}
public static function addDays(date:Date, days:Number):Date {
return addHours(date, days*24);
}
public static function addHours(date:Date, hrs:Number):Date {
return addMinutes(date, hrs*60);
}
public static function addMinutes(date:Date, mins:Number):Date {
return addSeconds(date, mins*60);
}
public static function addSeconds(date:Date, secs:Number):Date {
var mSecs:Number = secs * 1000;
var sum:Number = mSecs + date.getTime();
return new Date(sum);
}
}Date 演算を実行する場合には、getTime を使用することが重要です。getTime はうるう年に対応しているので、次の疑似コードのような if 文が不要です。
function addMonths(num:Number):void {
currentMonth = currentMonth + num;
if(currentMonth > 12) {
currentYear++;
currentMonth = currentMonth - 12;
}
}
AS3 function getTimezoneOffset():Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
世界時（UTC）とコンピュータのローカル時間の差（分単位）を返します。
戻り値 | Number — この分をコンピュータのローカル時間に加算すると世界時と等しくなります。コンピュータの時刻が世界時より遅い時間に設定されている場合、戻り値は負の数になります。 |
例
次の例では、新しい Date オブジェクト
now をパラメータの指定なしで作成します。次に、
getTimezoneOffset() メソッドを呼び出し、
now が作成された時刻と世界時の差（分単位）を取得します。さらに、この結果を 60 で除算して、タイムゾーンのオフセットを時間単位に変換します。
var date:Date = new Date();
trace(date.getTimezoneOffset() / 60);
AS3 function getUTCDate():Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトの日付（1 ～ 31 の整数）を世界時（UTC）で返します。
戻り値 | Number —
Date オブジェクトが表す UTC の日付（1 ～ 31）です。
|
関連項目
例
次の例では、新しい Date オブジェクト
someBirthday を作成し、パラメータに
year（
1974）、
month（
10 = 11 月）、
day（
30）、
hour（
1）、
minute（
20）を指定します。
getUTCDate() メソッドを呼び出し、日付を UTC で取得します。
var someBirthday:Date = new Date(1974, 10, 30, 1, 20);
trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974
trace(someBirthday.getUTCDate()); // 30
AS3 function getUTCDay():Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
この Date の曜日（日曜日は 0、月曜日は 1 など）を世界時（UTC）で返します。
戻り値 | Number —
Date オブジェクトが表す UTC の曜日（0 ～ 6）です。
|
関連項目
例
次の例では、新しい Array オブジェクト
weekDayLabels を作成して、エレメント
[Sunday,Monday,Tuesday,Wednesday,Thursday,Friday,Saturday] を設定し、次に、新しい Date オブジェクト
someBirthday を作成して、パラメータに
year（
1974）、
month（
10 = 11 月）、
day（
30）、
hour（
1）、
minute（
20）を指定します。 次に
getUTCDay() メソッドを 2 回呼び出します。1 回目は日付を 6 という数値で表示し、2 回目は
weekDayLabels を使用して曜日を UTC で表示します。
var weekDayLabels:Array = new Array("Sunday",
"Monday",
"Tuesday",
"Wednesday",
"Thursday",
"Friday",
"Saturday");
var someBirthday:Date = new Date(1974, 10, 30, 1, 20);
trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974
trace(someBirthday.getUTCDay()); // 6
trace(weekDayLabels[someBirthday.getUTCDay()]); // Saturday AS3 function getUTCFullYear():Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトの 4 桁の年を世界時（UTC）で返します。
戻り値 | Number —
Date オブジェクトが表す UTC の 4 桁の年です。
|
関連項目
例
次の例では、新しい Date オブジェクト
someBirthday を作成し、パラメータに
year（
1974）、
month（
10 = 11 月）、
day（
30）、
hour（
1）、
minute（
20）を指定します。 次に、
getUTCFullYear() メソッドを呼び出し、4 桁の年を UTC で取得します。
var someBirthday:Date = new Date(1974, 10, 30, 1, 20);
trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974
trace(someBirthday.getUTCFullYear()); // 1974
AS3 function getUTCHours():Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトの時（0 ～ 23 の整数）を世界時（UTC）で返します。
戻り値 | Number —
Date オブジェクトが表す UTC の時（0 ～ 23）です。
|
関連項目
例
次の例では、新しい Date オブジェクト
someBirthday を作成し、パラメータに
year（
1974）、
month（
10 = 11 月）、
day（
30）、
hour（
1）、
minute（
20）を指定します。 次に、
getHours() メソッドと
getMinutes() メソッドを呼び出し、時と分を 24 時間形式で取得します。 最後に、ストリング
localTime を作成し、関数
getUSClockTime() の呼び出し結果を割り当てます。この関数は、
getHours() と
getMinutes() を再度呼び出します。これにより、時間
03:05 PM が表示されます。 最後に、String 変数
utcTime を
localTime と同様の方法で作成します。この場合、結果は同じになります。
var someBirthday:Date = new Date(1974, 10, 30, 15, 5);
trace(someBirthday); // Sat Nov 30 15:20:00 GMT-0800 1974
trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 15:5
var localTime:String = getUSClockTime(someBirthday.getHours(), someBirthday.getMinutes());
trace(localTime); // 03:05 PM
var utcTime:String = getUSClockTime(someBirthday.getUTCHours(), someBirthday.getUTCMinutes());
trace(utcTime); // 11:05 PM
function getUSClockTime(hrs:uint, mins:uint):String {
var modifier:String = "PM";
var minLabel:String = doubleDigitFormat(mins);
if(hrs > 12) {
hrs = hrs-12;
} else if(hrs == 0) {
modifier = "AM";
hrs = 12;
} else if(hrs < 12) {
modifier = "AM";
}
return (doubleDigitFormat(hrs) + ":" + minLabel + " " + modifier);
}
function doubleDigitFormat(num:uint):String {
if(num < 10) {
return ("0" + num);
}
return num;
} AS3 function getUTCMilliseconds():Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトのミリ秒（0 ～ 999 の整数）部分を世界時（UTC）で返します。
戻り値 | Number —
Date オブジェクトの UTC のミリ秒部分です。
|
例
次の例では、新しい Date オブジェクト
now をパラメータの指定なしで作成します。次に、
getUTCMilliseconds() メソッドを呼び出し、Date オブジェクト
now の作成時点のミリ秒 を UTC で取得します。
var now:Date = new Date();
trace(now.getUTCMilliseconds());
AS3 function getUTCMinutes():Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトの分（0 ～ 59 の整数）部分を世界時（UTC）で返します。
戻り値 | Number —
Date オブジェクトの UTC の分部分です。
|
例
次の例では、新しい Date オブジェクト
now をパラメータの指定なしで作成します。次に、
getUTCMinutes() メソッドを呼び出し、Date オブジェクト
now の作成時点の分を UTC で取得します。
var now:Date = new Date();
trace(now.getUTCMinutes());
AS3 function getUTCMonth():Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトの月（0（1 月） ～ 11（12 月））部分を世界時（UTC）で返します。
戻り値 | Number —
Date オブジェクトの UTC の月部分です。
|
関連項目
例
次の例では、新しい Array オブジェクト
monthLabels を作成して、
January から
December までのエレメントを設定し、次に、パラメータを指定せずに新しい Date オブジェクト
now を作成します。 次に、
getUTCMonth() メソッドを 2 回呼び出します。1 回目は、Date オブジェクト作成時点の
now の月の数値を、2 回目は月の名前を UTC で返します。
var monthLabels:Array = new Array("January",
"February",
"March",
"April",
"May",
"June",
"July",
"August",
"September",
"October",
"November",
"December");
var now:Date = new Date();
trace(now.getMonth());
trace(now.getUTCMonth());
trace(monthLabels[now.getUTCMonth()]); AS3 function getUTCSeconds():Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトの秒（0 ～ 59 の整数）部分を世界時（UTC）で返します。
戻り値 | Number —
Date オブジェクトの UTC の秒部分です。
|
例
次の例では、新しい Date オブジェクト
now をパラメータの指定なしで作成します。次に、
getUTCSeconds() メソッドを呼び出し、Date オブジェクト
now の作成時点の秒を UTC で取得します。
var now:Date = new Date();
trace(now.getUTCSeconds());
public static function parse(date:String):Number日付を表すストリングを、1970 年 1 月 1 日（UTC）から経過したミリ秒数に相当する数値に変換します。
パラメータ
| date:String —
Date.toString() の出力形式に準じた日付のストリング表現です。 Date.toString() の出力の日付形式は、次のとおりです。
Day Mon DD HH:MM:SS TZD YYYY
次に実際の使用例を示します。
Wed Apr 12 15:30:17 GMT-0700 2006
タイムゾーン指定（TZD）は、常に GMT-HHMM または UTC-HHMM の形式になります。これは、グリニッジ標準時（GMT）を基準にした時間と分のオフセットを示します。なお、グリニッジ標準時は現在は世界時（UTC）とも呼ばれています。年、月、曜日は、スラッシュ（/）またはスペースで区切ることができますが、ダッシュ（-）で区切ることはできません。 他にも、次のような形式がサポートされます。月、曜日、年だけというように、これらの形式の一部分を含めることもできます。
MM/DD/YYYY HH:MM:SS TZD
HH:MM:SS TZD Day Mon/DD/YYYY
Mon DD YYYY HH:MM:SS TZD
Day Mon DD HH:MM:SS TZD YYYY
Day DD Mon HH:MM:SS TZD YYYY
Mon/DD/YYYY HH:MM:SS TZD
YYYY/MM/DD HH:MM:SS TZD
|
戻り値 | Number — 1970 年 1 月 1 日（UTC）から経過したミリ秒数を表す数値です。 |
関連項目
例
次の例では、1974 年 11 月 30 日の日付ストリングを
dateParsed に割り当てます。次に、
Date.parse() メソッドを呼び出し、この日付を 1970 年 1 月 1 日からのミリ秒数に変換します。
var dateParsed:String = "Sat Nov 30 1974";
var milliseconds:Number = Date.parse(dateParsed);
trace(milliseconds); // 155030400000
AS3 function setDate(day:Number):Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
月内の日付をローカル時間で設定し、新しい時刻をミリ秒で返します。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。
パラメータ
戻り値 例
次の例では、新しい Date オブジェクト
someBirthday を作成し、パラメータに
year（
1974）、
month（
10 = 11 月）、
day（
30）、
hour（
1）、
minute（
20）を指定します。 次に、
getDate() メソッドを呼び出し、日付を取得します。次に、
setDate() を呼び出して（
day パラメータに
20 を設定）から、
getDate() を再度呼び出します。これにより、新しく設定された日付を取得します。
var someBirthday:Date = new Date(1974, 10, 30, 1, 20);
trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974
trace(someBirthday.getDate()); // 30
someBirthday.setDate(20);
trace(someBirthday.getDate()); // 20
AS3 function setFullYear(year:Number, month:Number, day:Number):Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
年をローカル時間で設定し、新しい時刻をミリ秒で返します。month パラメータと day パラメータを指定すると、両方はローカル時間に設定されます。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。
このメソッドを呼び出しても Date オブジェクトの他のフィールドは変更されませんが、このメソッドを呼び出した結果として曜日が変わった場合には、Date.getUTCDay() と Date.getDay() は新しい値を返すことがあります。
パラメータ
| year:Number — 年を示す 4 桁の数値です。2 桁の数値は 4 桁の年の省略形を表しません。例えば、99 は 1999 年ではなく、99 年です。 |
| |
| month:Number — 0（1 月）～ 11（12 月）の整数です。 |
| |
| day:Number — 1 ～ 31 の数値です。 |
戻り値関連項目
例
次の例では、新しい Date オブジェクト
someBirthday を作成し、パラメータに
year（
1974）、
month（
10 = 11 月）、
day（
30）、
hour（
1）、
minute（
20）を指定します。 次に、メソッド
getFullYear() を呼び出し、4 桁の年を取得します。次に、
setFullYear() を呼び出して（
year パラメータに
2000 を設定）から、
getFullYear() を再度呼び出します。これにより、新しく設定された年を取得します。
var someBirthday:Date = new Date(1974, 10, 30, 1, 20);
trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974
trace(someBirthday.getFullYear()); // 1974
someBirthday.setFullYear(2000);
trace(someBirthday.getFullYear()); // 2000
AS3 function setHours(hour:Number, minute:Number, second:Number, millisecond:Number):Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
時をローカル時間で設定し、新しい時刻をミリ秒で返します。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。
パラメータ
| hour:Number — 0（0 時）～ 23（午後 11 時）の整数です。 |
| |
| minute:Number — 0 ～ 59 の整数です。 |
| |
| second:Number — 0 ～ 59 の整数です。 |
| |
| millisecond:Number — 0 ～ 999 の整数です。 |
戻り値 例
次の例では、新しい Date オブジェクト
someBirthday を作成し、パラメータに
year（
1974）、
month（
10 = 11 月）、
day（
30）、
hour（
1）、
minute（
20）を指定します。 次に、メソッド
getHours() と
getMinutes() を呼び出し、時と分を取得します。次に、
setHours() を呼び出して（
hour パラメータに
12 を設定）から、
getHours() と
getMinutes() を再度呼び出します。これにより、新しく設定された時と分を取得します。
var someBirthday:Date = new Date(1974, 10, 30, 15, 20);
trace(someBirthday); // Sat Nov 30 15:20:00 GMT-0800 1974
trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 15:20
someBirthday.setHours(12);
trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 12:20
AS3 function setMilliseconds(millisecond:Number):Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
ミリ秒をローカル時間で設定し、新しい時刻をミリ秒で返します。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。
パラメータ
| millisecond:Number — 0 ～ 999 の整数です。 |
戻り値 例
次の例では、新しい Date オブジェクト
now をパラメータの指定なしで作成します。次に、
getMilliseconds() メソッドを呼び出し、
now 作成時点のミリ秒を取得します。次に、別の Date オブジェクト
before を、
setMilliseconds() を追加で呼び出して（
millisecond パラメータに
4 を設定）作成します。次に、
getMilliseconds() を再度呼び出して、新しく設定されたミリ秒を取得します。
var now:Date = new Date();
trace(now);
trace(now.getMilliseconds());
var before:Date = new Date(now.setMilliseconds(4));
trace(before);
trace(before.getMilliseconds());
AS3 function setMinutes(minute:Number, second:Number, millisecond:Number):Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
分をローカル時間で設定し、新しい時刻をミリ秒で返します。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。
パラメータ
| minute:Number — 0 ～ 59 の整数です。 |
| |
| second:Number — 0 ～ 59 の整数です。 |
| |
| millisecond:Number — 0 ～ 999 の整数です。 |
戻り値 例
次の例では、新しい Date オブジェクト
now をパラメータの指定なしで作成します。次に、
getMinutes() メソッドを呼び出し、
now 作成時点の分を取得します。次に、別の Date オブジェクト
before を、
setMinutes() を追加で呼び出して（
minute パラメータに
0 を設定）作成します。次に、
getMinutes() を再度呼び出して、新しく設定された分を取得します。
var now:Date = new Date();
trace(now);
trace(now.getMinutes());
var before:Date = new Date(now.setMinutes(0));
trace(before);
trace(before.getMinutes());
AS3 function setMonth(month:Number, day:Number):Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
月と、オプションで日付をローカル時間で設定し、新しい時刻をミリ秒で返します。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。
パラメータ
| month:Number — 0（1 月）～ 11（12 月）の整数です。 |
| |
| day:Number — 1 ～ 31 の整数です。 |
戻り値 例
次の例では、新しい Array オブジェクト
monthLabels を作成して、
January から
December までのエレメントを設定し、次に、パラメータを指定せずに新しい Month オブジェクト
now を作成します。 次に、
getMonth() メソッドを呼び出し、
now 作成時点の月を取得します。次に、
setMonth() を呼び出して（
month パラメータに
0 を設定）から、
getMonth() を再度呼び出します。これにより、新しく設定された月を取得します。
var monthLabels:Array = new Array("January",
"February",
"March",
"April",
"May",
"June",
"July",
"August",
"September",
"October",
"November",
"December");
var now:Date = new Date();
trace(now.getMonth());
trace(monthLabels[now.getMonth()]);
now.setMonth(0);
trace(now.getMonth()); // 0
trace(monthLabels[now.getMonth()]); // January AS3 function setSeconds(second:Number, millisecond:Number):Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
秒をローカル時間で設定し、新しい時刻をミリ秒で返します。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。
パラメータ
| second:Number — 0 ～ 59 の整数です。 |
| |
| millisecond:Number — 0 ～ 999 の整数です。 |
戻り値 例
次の例では、新しい Date オブジェクト
now をパラメータの指定なしで作成します。次に、
getseconds() メソッドを呼び出し、
now 作成時点の秒を取得します。次に、
setSeconds() を呼び出して（
second パラメータに
0 を設定）から、
getSeconds() を再度呼び出します。これにより、新しく設定された秒を取得します。
var now:Date = new Date();
trace(now.getSeconds());
now.setSeconds(0);
trace(now.getSeconds()); // 0
AS3 function setTime(millisecond:Number):Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
日付を 1970 年 1 月 1 日 0 時からのミリ秒数で設定し、新しい時刻をミリ秒で返します。
パラメータ
| millisecond:Number — 整数値です。0 は世界時（UTC）の 1 月 1 日 0 時です。 |
戻り値 例
次の例では、新しい Date オブジェクト
now をパラメータの指定なしで作成します。次に
setTime() メソッドを呼び出します。パラメータ
millisecond には
-1292601600000 を設定します。これにより時刻は
Tue Jan 15 00:00:00 GMT-0800 1929 に設定されます。
var now:Date = new Date();
trace(now);
now.setTime(-1292601600000);
trace(now); // Tue Jan 15 00:00:00 GMT-0800 1929
AS3 function setUTCDate(day:Number):Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
月内の日付を世界時（UTC）で設定し、新しい時刻をミリ秒で返します。このメソッドを呼び出しても、Date オブジェクトの他のフィールドは変更されませんが、このメソッドを呼び出した結果として曜日が変わった場合には、Date.getUTCDay() メソッドと Date.getDay() メソッドは新しい値を返すことがあります。
パラメータ
戻り値関連項目
例
次の例では、新しい Date オブジェクト
someBirthday を作成し、パラメータに
year（
1974）、
month（
10 = 11 月）、
day（
30）、
hour（
1）、
minute（
20）を指定します。
getUTCDate() メソッドを呼び出すと、月内の日付が正しく返されます。次に、
setUTCDate() を呼び出します。パラメータ
day には
1 を設定します。
trace() ステートメントで日付が正しく設定されたことを確認します。
var someBirthday:Date = new Date(1974, 10, 30, 1, 20);
trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974
trace(someBirthday.getUTCDate()); // 30
someBirthday.setUTCDate(1);
trace(someBirthday); // Fri Nov 1 01:20:00 GMT-0800 1974
AS3 function setUTCFullYear(year:Number, month:Number, day:Number):Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
年を世界時（UTC）で設定し、新しい時刻をミリ秒で返します。
このメソッドでは、オプションで月と日を設定することもできます。このメソッドを呼び出しても他のフィールドは変更されませんが、このメソッドを呼び出した結果として曜日が変わった場合には、Date.getUTCDay() と Date.getDay() メソッドは新しい値を返すことがあります。
パラメータ
| year:Number — 4 桁の年（2000 など）を表す整数です。 |
| |
| month:Number — 0（1 月）～ 11（12 月）の整数です。 |
| |
| day:Number — 1 ～ 31 の整数です。 |
戻り値関連項目
例
次の例では、新しい Date オブジェクト
someBirthday を作成し、パラメータに
year（
1974）、
month（
10 = 11 月）、
day（
30）、
hour（
1）、
minute（
20）を指定します。 メソッド
getUTCFullYear() を呼び出すと、4 桁の年が正しく返されます。次に、
setUTCFullYear() を呼び出します。パラメータ
year には
1975 を設定します。
trace() ステートメントで年が正しく設定されたことを確認します。
var someBirthday:Date = new Date(1974, 10, 30, 1, 20);
trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974
trace(someBirthday.getUTCFullYear()); // 1974
someBirthday.setUTCFullYear(1975);
trace(someBirthday); // Thu Nov 30 01:20:00 GMT-0800 1975
AS3 function setUTCHours(hour:Number, minute:Number, second:Number, millisecond:Number):Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
時を世界時（UTC）で設定し、新しい時刻をミリ秒で返します。オプションで、分、秒、およびミリ秒を指定することができます。
パラメータ
| hour:Number — 0（0 時）～ 23（午後 11 時）の整数です。 |
| |
| minute:Number — 0 ～ 59 の整数です。 |
| |
| second:Number — 0 ～ 59 の整数です。 |
| |
| millisecond:Number — 0 ～ 999 の整数です。 |
戻り値 例
次の例では、新しい Date オブジェクト
someBirthday を作成し、パラメータに
year（
1974）、
month（
10 = 11 月）、
day（
30）、
hour（
1）、
minute（
20）を指定します。 次に、メソッド
getHours()、
getMinutes()、
getUTCHours()、
getUTCMinutes() を呼び出し、時と分を取得します。
setUTCHours() を呼び出します。パラメータ
hour には
12 を設定します。次に、メソッド
getHours()、
getMinutes()、
getUTCHours()、
getUTCMinutes() を再度呼び出し、更新された時を正しく表示します。
var someBirthday:Date = new Date(1974, 10, 30, 15, 20);
trace(someBirthday); // Sat Nov 30 15:20:00 GMT-0800 1974
trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 15:20
trace(someBirthday.getUTCHours() + ":" + someBirthday.getUTCMinutes()); // 23:20
someBirthday.setUTCHours(12);
trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 4:20
trace(someBirthday.getUTCHours() + ":" + someBirthday.getUTCMinutes()); // 12:20
AS3 function setUTCMilliseconds(millisecond:Number):Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
ミリ秒を世界時（UTC）で設定し、新しい時刻をミリ秒で返します。
パラメータ
| millisecond:Number — 0 ～ 999 の整数です。 |
戻り値 例
次の例では、新しい Date オブジェクト
now をパラメータの指定なしで作成します。次に、
getUTCMilliseconds() メソッドを呼び出し、
now 作成時点の UTCMilliseconds を取得します。次に、別の Date オブジェクト
before を、
setUTCMilliseconds() を呼び出して（
millisecond パラメータに
4 を設定）作成します。次に、
getUTCMilliseconds() を再度呼び出して、新しく設定されたミリ秒を取得します。
var now:Date = new Date();
trace(now);
trace(now.getUTCMilliseconds());
var before:Date = new Date(now.setUTCMilliseconds(4));
trace(before);
trace(before.getUTCMilliseconds());
AS3 function setUTCMinutes(minute:Number, second:Number, millisecond:Number):Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
分を世界時（UTC）で設定し、新しい時刻をミリ秒で返します。オプションで、秒とミリ秒を指定することができます。
パラメータ
| minute:Number — 0 ～ 59 の整数です。 |
| |
| second:Number — 0 ～ 59 の整数です。 |
| |
| millisecond:Number — 0 ～ 999 の整数です。 |
戻り値 例
次の例では、新しい Date オブジェクト
now をパラメータの指定なしで作成します。次に、
getUTCMinutes() メソッドを呼び出し、
now 作成時点の UTCMinutes を取得します。次に、別の Date オブジェクト
before を、
setUTCMinutes() を呼び出して（
minute パラメータに
0 を設定）作成します。次に、
getUTCMinutes() を再度呼び出して、新しく設定された分を取得します。
var now:Date = new Date();
trace(now);
trace(now.getUTCMinutes());
var before:Date = new Date(now.setUTCMinutes(0));
trace(before);
trace(before.getUTCMinutes());
AS3 function setUTCMonth(month:Number, day:Number):Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
月、および日（オプション）を世界時（UTC）で設定し、新しい時刻をミリ秒で返します。このメソッドを呼び出しても他のフィールドは変更されませんが、このメソッドを呼び出した結果として曜日が変わった場合には、Date.getUTCDay() メソッドと Date.getDay() メソッドは新しい値を返すことがあります。
パラメータ
| month:Number — 0（1 月）～ 11（12 月）の整数です。 |
| |
| day:Number — 1 ～ 31 の整数です。 |
戻り値関連項目
例
次の例では、新しい Array オブジェクト
UTCMonthLabels を作成して、
January から
December までのエレメントを設定し、次に、パラメータを指定せずに新しい UTCMonth オブジェクト
now を作成します。 次に、
getUTCMonth() メソッドを呼び出し、
now 作成時点の UTCMonth を取得します。次に、
setUTCMonth() を呼び出して（
month パラメータに
0 を設定）から、
getUTCMonth() を再度呼び出します。これにより、新しく設定された月を取得します。
var UTCMonthLabels:Array = new Array("January",
"February",
"March",
"April",
"May",
"June",
"July",
"August",
"September",
"October",
"November",
"December");
var now:Date = new Date();
trace(now.getUTCMonth());
trace(UTCMonthLabels[now.getUTCMonth()]);
now.setUTCUTCMonth(0);
trace(now.getUTCMonth()); // 0
trace(UTCMonthLabels[now.getUTCMonth()]); // January AS3 function setUTCSeconds(second:Number, millisecond:Number):Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
秒、およびオプションでミリ秒を世界時（UTC）で設定し、新しい時刻をミリ秒で返します。
パラメータ
| second:Number — 0 ～ 59 の整数です。 |
| |
| millisecond:Number — 0 ～ 999 の整数です。 |
戻り値 例
次の例では、新しい Date オブジェクト
now をパラメータの指定なしで作成します。次に、
getUTCSeconds() メソッドを呼び出し、
now 作成時点の秒を取得します。次に、
setUTCSeconds() を呼び出して（
second パラメータに
0 を設定）から、
getUTCSeconds() を再度呼び出します。これにより、新しく設定された秒を取得します。
var now:Date = new Date();
trace(now.getUTCSeconds());
now.setUTCSeconds(0);
trace(now.getUTCSeconds()); // 0
AS3 function toDateString():String| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
曜日と日付のみのストリング表現を返します。時刻またはタイムゾーンは含まれません。次のメソッドと対照を成します。
-
Date.toTimeString() は時刻とタイムゾーンのみを返します。
-
Date.toString() は曜日と日付のみでなく、時刻とタイムゾーンも返します。
戻り値関連項目
例
次の例では、パラメータ設定なしで新しい Date オブジェクト
now を作成し、
trace() ステートメントの中で、次のメソッドを呼び出します。
-
toString：now のすべてのパラメータ（now が作成されたときの）を表示します。
-
toDateString()：day、month、year パラメータ（now が作成されたときの）を表示します。
var now:Date = new Date();
trace(now);
trace(now.toDateString());
AS3 function toLocaleDateString():String| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
曜日と日付のみのストリング表現を返します。時刻またはタイムゾーンは含まれません。このメソッドは、Date.toDateString と同じ値を返します。 次のメソッドと対照を成します。
-
Date.toTimeString() は時刻とタイムゾーンのみを返します。
-
Date.toString() は曜日と日付のみでなく、時刻とタイムゾーンも返します。
戻り値 | String —
曜日と日付のみの String 表現です。
|
関連項目
AS3 function toLocaleString():String| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
曜日、日付、時刻のストリング表現を、指定されたローカル時間で返します。同じ情報（およびタイムゾーン）をストリングの最後に年を付けて返す Date.toString() メソッドと対照を成します。
戻り値 | String —
Date オブジェクトのストリング表現をローカルタイムゾーンで返します。
|
AS3 function toLocaleTimeString():String| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
時刻のみのストリング表現を返します。曜日、日付、年、またはタイムゾーンは含まれません。時刻とタイムゾーンを返す Date.toTimeString() メソッドと対照を成します。
戻り値 | String — 時刻とタイムゾーンのみのストリング表現です。 |
関連項目
AS3 function toString():String| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
曜日、日付、時刻、およびタイムゾーンのストリング表現を返します。出力の日付形式は、次のとおりです。
Day Mon Date HH:MM:SS TZD YYYY
次に実際の使用例を示します。
Wed Apr 12 15:30:17 GMT-0700 2006
戻り値 | String —
Date オブジェクトのストリング表現です。
|
例
次の例では、パラメータを指定せずに Date オブジェクト
now を作成し、次に、
toString を
trace() ステートメント内で呼び出します。これにより
now のすべてのパラメータ（
now を作成したときの）を表示します。
var now:Date = new Date();
trace(now);
AS3 function toTimeString():String| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
時刻とタイムゾーンのみのストリング表現を返します。曜日と日付は含まれません。曜日と日付のみを返す Date.toDateString() メソッドと対照を成します。
戻り値 | String — 時刻とタイムゾーンのみのストリング表現です。 |
関連項目
AS3 function toUTCString():String| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
曜日、日付、および時刻のストリング表現を世界時（UTC）で返します。例えば、2005 年 2 月 1 日を Tue Feb 1 00:00:00 2005 UTC として返します。
戻り値 | String —
Date オブジェクトの UTC のストリング表現です。
|
関連項目
public static function UTC(year:Number, month:Number, date:Number = 1, hour:Number = 0, minute:Number = 0, second:Number = 0, millisecond:Number = 0):Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
1970 年 1 月 1 日 0 時 (世界時) からパラメータで指定された時刻までのミリ秒数を返します。このメソッドでは世界時を使用するのに対し、Date コンストラクタではローカル時間を使用します。
このメソッドは、UTC の日付を Date クラスのコンストラクタに渡す場合に便利です。Date クラスのコンストラクタはミリ秒オフセットを引数として受け取るので、Date.UTC() メソッドを使用して UTC の日付を対応のミリ秒オフセットに変換し、このオフセットを引数として Date クラスコンストラクタに送ることができます。
パラメータ
| year:Number — 年を表す 4 桁の整数（2000 など）です。 |
| |
| month:Number — 0（1 月）～ 11（12 月）の整数です。 |
| |
| date:Number (default = 1) |
| |
| hour:Number (default = 0) |
| |
| minute:Number (default = 0) |
| |
| second:Number (default = 0) |
| |
| millisecond:Number (default = 0) |
戻り値 | Number — 1970 年 1 月 1 日から指定された日時までのミリ秒数です。 |
例
次の例では、新しい Date オブジェクト
someBirthday を作成し、パラメータにローカル時間の
year（
1974）、
month（
10 = 11 月）、
day（
30）、
hour（
1）、
minute（
20）を指定します。 次に、
UTC() を
setTime() メソッド内で呼び出し、これらのパラメータを世界時にリセットします。
var someBirthday:Date = new Date(1974, 10, 30, 15, 20);
trace(someBirthday.toString());
someBirthday.setTime(Date.UTC(1974, 10, 30, 15, 20));
trace(someBirthday.toString());
AS3 function valueOf():Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Date オブジェクトの 1970 年 1 月 1 日 0 時（世界時）からのミリ秒数を返します。
戻り値 | Number —
Date オブジェクトが表す 1970 年 1 月 1 日からのミリ秒数です。
|
例
次の例では、パラメータを指定せずに新しい Date オブジェクト
now を作成し、次に、
getTime() メソッドを呼び出して、1970 年 1 月 1 日 0 時 から
now が作成された時刻までのミリ秒数を取得します。次に、
valueOf() を呼び出して同じ値を取得します。
var now:Date = new Date();
trace(now.getTime());
trace(now.valueOf());
次の例では、次に示す変数を割り当てる場合の
Date() コンストラクタのさまざまな使用法を示しています。
-
myDate1 では、パラメータを指定せずに Date() を呼び出します。これにより、myDate1 には、使用しているシステムの日時に基づいた現在の日時が設定されます。
-
myDate2 では、Date() を呼び出し、パラメータに year（2000）、month（0 = 1 月）、day（1）を渡します。
-
myDate3 では、Date() を呼び出し、パラメータに year（65 = 1965）、month（2 = 3 月）、day（6）、hour（9）、minute（30）、second（15）、millisecond -+（0）を渡します。
-
myDate4 では、Date() を呼び出し、1970 年 1 月 1 日 0:00:00（世界時）よりも何ミリ秒前（値が負であるため）なのかを表す数値を指定します。
package {
import flash.display.Sprite;
public class DateExample extends Sprite{
public function DateExample() {
var myDate1:Date = new Date();
trace(myDate1); // [NOW]
var myDate2:Date = new Date(2000, 0, 1);
trace(myDate2); // Sat Jan 1 00:00:00 GMT-0800 2000
var myDate3:Date = new Date(65, 2, 6, 9, 30, 15, 0);
trace(myDate3); // Sat Mar 6 09:30:15 GMT-0800 1965
var myDate4:Date = new Date(-14159025000);
trace(myDate4); // Sun Jul 20 19:56:15 GMT-0700 1969
}
}
}
© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Thu Jan 8 2009, 12:14 AM -08:00 
Object
継承されるパブリックプロパティを隠す
継承されるパブリックプロパティを表示