JavaScript 標準ライブラリ Date

出典: フリー教科書『ウィキブックス（Wikibooks）』

目次 1 Dateオブジェクト 1.1 Date.parse( string ) 1.2 Date.UTC (year, month [, date [, hours [, minutes [, seconds [, ms ] ] ] ] ] ) 1.3 ローカル時間取得のメソッド 1.3.1 getFullYear() 1.3.2 getMonth() 1.3.3 getDate() 1.3.4 getDay() 1.3.5 getHours() 1.3.6 getSeconds() 1.3.7 getMinutes() 1.3.8 getMilliseconds() 1.3.9 setFullYear(year [, month [, date ] ] ) 1.3.10 setMonth(month [, date ] ) 1.3.11 setDate(date) 1.3.12 setHours(hour [, min [, sec [, ms ] ] ] ) 1.3.13 setMinutes(min [, sec [, ms ] ] ) 1.3.14 setSeconds(sec [, ms ] ) 1.3.15 setMilliseconds(ms) 1.4 協定世界時のメソッド 1.4.1 getUTCFullYear() 1.4.2 getUTCMonth() 1.4.3 getUTCDate() 1.4.4 getUTCDay() 1.4.5 getUTCMinutes() 1.4.6 getUTCSeconds() 1.4.7 getUTCMilliseconds() 1.4.8 setUTCFullYear(year [, month [, date ] ] ) 1.4.9 setUTCMonth(month [, date ] ) 1.4.10 setUTCDate(date) 1.4.11 setUTCHours(hour [, min [, sec [, ms ] ] ] ) 1.4.12 setUTCMinutes(min [, sec [, ms ] ] ) 1.4.13 setUTCSeconds(sec [, ms ] ) 1.4.14 setUTCMilliseconds(ms) 1.5 時間取得メソッド 1.5.1 toString() 1.5.2 toDateString() 1.5.3 toTimeString() 1.5.4 toLocaleString() 1.5.5 toLocaleDateString() 1.5.6 toLocaleTimeString() 1.5.7 toUTCString() 1.6 その他 1.6.1 valueOf() 1.6.2 getTime() 1.6.3 setTime(time) 1.6.4 getTimezoneOffset()

[編集] Dateオブジェクト

Dateオブジェクトは日付を扱うためのオブジェクトである。 次の様に書くことで、現在時を取得する事が出来る。

var d = new Date(); 

この後、toStringメソッド等を利用して日付を文字列に変換して人間側で読める形式にしていく。

日付を指定してオブジェクトを作成したい場合には、次の様に日付を指定していく。

var d = new Date( 2007, 10, 21 );	// 2007年11月21日のオブジェクトを作成 
var d = new Date( 2007, 10, 21, 8, 13, 21 );	// 2007年11月21日 8:13:21のオブジェクトを作成
var d = new Date( 99, 6 );	// 1999年7の月のオブジェクトを作成 

(年を0～99で指定した場合は19xx年を設定するため、西暦0～99年を指定したいときはsetFullYearを利用する。)

Dateオブジェクトには次の問題点がある。

まず、Dateオブジェクトは有限の範囲の日付しか扱えない。扱える範囲は1970年1月1日を基準として±28万5千年程度なので、実用上問題は無いと思われるが有限であることは把握しておくべきである。

また、コンピューターの時計の場合、実際の地球の自転と標準時との誤差を埋めるため、数年に一度程度、閏秒(うるうびょう)が挿入されるが、ECMA標準では挿入されない仕様となっている。そのため、秒単位では違いがある可能性がある。

• 閏秒(うるうびょう)

[編集] Date.parse( string )

文字列を解析して、1970年1月1日からの経過秒(ミリ秒)で返す。

解析した結果はDateオブジェクトで返されるわけではないので、Dateオブジェクトへの変換は次の様に行う。

var d = new Date();
d.setTime(Date.parse("2001/9/11")); 

実際にどこまでの解析を行うかは実装に依存している。

[編集] Date.UTC (year, month [, date [, hours [, minutes [, seconds [, ms ] ] ] ] ] )

1970年1月1日からの経過秒(ミリ秒)で返す。

var d = new Date();
d.setTime( Date.UTC( 2001, 9, 11 ) ); 

[編集] ローカル時間取得のメソッド

[編集] getFullYear()

西暦を返します。

[編集] getMonth()

月を返す。返される値は0～11の範囲の値を取り、実際の月数より1少ない。 つまり1月の場合は0、2月の場合は1が返る。

[編集] getDate()

日付(1～31)を取得する。

[編集] getDay()

曜日を取得する。

[編集] getHours()

時間(0～23)を取得する。

[編集] getSeconds()

分(0～59)を取得する。

[編集] getMinutes()

秒(0～59)を取得する。

[編集] getMilliseconds()

ミリ秒(1/1000秒単位)を取得する。

[編集] setFullYear(year [, month [, date ] ] )

年を設定する。

[編集] setMonth(month [, date ] )

月を設定する。

[編集] setDate(date)

日を設定する。

[編集] setHours(hour [, min [, sec [, ms ] ] ] )

時を設定する。

[編集] setMinutes(min [, sec [, ms ] ] )

分を設定する。

[編集] setSeconds(sec [, ms ] )

秒を設定する。

[編集] setMilliseconds(ms)

ミリ秒を設定する。

[編集] 協定世界時のメソッド

先述したメソッドの場合、使用するマシンの地域によって時間に違いが出るため、ロンドンのグリニッジ天文台を基準に位置によらない世界共通の時間として利用している。 協定世界時(Universal Time, Coordinated)は、現在グリニッジ標準時(GMT)と置き換わって世界標準時として利用されているが生活実感として困るほどの差異は無い。

• 協定世界時(UTC)

[編集] getUTCFullYear()

協定世界時での年を取得する。

[編集] getUTCMonth()

協定世界時での月を取得する。

[編集] getUTCDate()

協定世界時での日付を取得する。

[編集] getUTCDay()

協定世界時での週を取得する。

[編集] getUTCMinutes()

協定世界時での秒分取得する。

[編集] getUTCSeconds()

協定世界時での秒を取得する。

[編集] getUTCMilliseconds()

協定世界時でのミリ秒を取得する。

[編集] setUTCFullYear(year [, month [, date ] ] )

協定世界時での年を設定します。

[編集] setUTCMonth(month [, date ] )

協定世界時での月を設定します。

[編集] setUTCDate(date)

協定世界時での日を設定します。

[編集] setUTCHours(hour [, min [, sec [, ms ] ] ] )

協定世界時での時間を設定します。

[編集] setUTCMinutes(min [, sec [, ms ] ] )

協定世界時での分を設定します。

[編集] setUTCSeconds(sec [, ms ] )

協定世界時での秒を設定します。

[編集] setUTCMilliseconds(ms)

協定世界時でのミリ秒を設定します。

[編集] 時間取得メソッド

これらのメソッドは時間を人間側で見るために取得するためのメソッドである。 基本的に人間の読みやすい形式に変換を行うが、標準仕様では書式が統一されていないため、どのように表示されるかは実装に依存しているのが現状である。 そのため、実装に依存しない統一された書式を必要とする場合は、プログラマ側でDateオブジェクトのメソッドをオーバーライド(上書き)してやる等をしてやる必要がある。

[編集] toString()

人間に読みやすい形で、文字列に変換した値を返す。 どの様な値を返すのかは仕様に定められておらす、実装によって微妙に値は異なる。

例えば主要なブラウザの場合、次の様な値が返る。

実装	書式
IE	Sun Mar 1 13:39:03 UTC+0900 2009
Firefox	Sun Mar 01 2009 13:39:03 GMT+0900
Opera	Sun, 01 Mar 2009 13:39:03 GMT+0900
Safari

[編集] toDateString()

toStringの変換のうち。年月日にあたる部分の文字列を返す。

実装	書式
IE	Sun Mar 1 2009
Firefox	Sun Mar 01 2009
Opera	Sun, 01 Mar 2009
Safari	Sun Mar 01 2009

[編集] toTimeString()

toStringの変換のうち。分秒にあたる部分の文字列を返す。

実装	書式
IE	13:56:06 UTC+0900
Firefox	13:56:06 GMT+0900
Opera	13:56:06 GMT+0900
Safari

[編集] toLocaleString()

使用している環境の、言語や文化に合わせた読みやすい形式の文字列で値を返す。 実際にどの様な値が返るかは実装に依存しており、一定していない。

例えば主要なWebブラウザの場合、日本語環境では次の様な値が返る。

実装	書式
IE	2009年3月1日 13:39:03
Firefox	2009年3月1日 13:39:03
Opera	2009/03/01 13:39:03
Safari	Sunday, March 01, 2009 13:39:03

[編集] toLocaleDateString()

toLocaleStringの変換のうち、年月日に相当する部分の文字列を返す。

実装	書式
IE	2009年3月1日
Firefox	2009年3月1日
Opera	2009/03/01
Safari	Sunday, March 01, 2009

[編集] toLocaleTimeString()

toLocaleStringの変換のうち。分秒にあたる部分の文字列を返す。 現在の主要なブラウザでは「13:39:03」の様な値が返るが、「13時39分3秒」の様な書式で値が返っても仕様上正しい。

[編集] toUTCString()

結果の書式はtoStrinメソッドと同じものであるが、ローカルの時間ではなく、協定世界時で結果を返す。

実装	書式
IE	Sun, 1 Mar 2009 04:39:03 UTC
Firefox	Sun, 01 Mar 2009 04:39:03 GMT
Opera	Sun, 01 Mar 2009 04:39:03 GMT
Safari	Sun, 01 Mar 2009 04:39:03 GMT

[編集] その他

[編集] valueOf()

1970年1月1日0時0分からの時間差をミリ秒単位で取得する。 これは一般的にはUnix時間と言われる時間でUnix内部での時間管理の仕組みと合わせてある(ただしUnix時間は秒区切りでミリ秒区切りではない)。

[編集] getTime()

動作はvalueOfメソッドと同じであるが歴史的経緯からこちらの方の使用を推奨する。

[編集] setTime(time)

1970年1月1日0時0分からの経過時間(ミリ秒)で時間を設定する。

[編集] getTimezoneOffset()

現在の環境とUTC標準との時間差を分で返す。 日本の場合はロンドンからは９時間前倒しなので、9(時間)×60(分)で「-540(分)」が返る。