JavaScript まとめ - 日付操作

日付操作

日付の取得、セット、文字列変換など、日時に関するリファレンス。

お品書き

● Date() コンストラクタ

【機能】	現在日時を Date へセットします。
【書式】	objDate = new Date()

【例】

// 現在日時情報を取得

objDate = new Date();
y = objDate.getFullYear();
m = objDate.getMonth()+1;
d = objDate.getDate();
document.write( y , "/" , m , "/" , d );

● Date( dateVal ) コンストラクタ

【機能】

指定した通算ミリ秒を Date へセットします。

【書式】

objDate = new Date( dateVal )

dateVal	1970 年 1 月 1 日午前 00:00:00 との間をミリ秒単位の世界協定時刻

【例】

// 1970/1/1の日付情報を取得

objDate = new Date( 0 );
y = objDate.getFullYear();
m = objDate.getMonth()+1;
d = objDate.getDate();
document.write( y , "/" , m , "/" , d );

● Date( year, month, date[, hours[, minutes[, seconds[,ms]]]] ) コンストラクタ

【機能】

指定した日時を Date へセットします。

【書式】

objDate = new Date( year, month, date[, hours[, minutes[, seconds[,ms]]]] )

year	年 (4桁)
month	月 (0 ～ 11) ※注意
date	日 (1 ～ 31)
hours	時 (0 ～ 23)
minutes	分 (0 ～ 59)
seconds	秒 (0 ～ 59)
ms	ミリ秒 (0 ～ 999)

【例】

// 2013/4/15 の日付情報を取得

objDate = new Date( 2013, 4-1, 15 );
y = objDate.getFullYear();
m = objDate.getMonth()+1;
d = objDate.getDate();
document.write( y , "/" , m , "/" , d );

● Date( "日付文字列" ) コンストラクタ

【機能】	指定した日時を Date へセットします。
【書式】	objDate = new Date( "日付文字列" )

【例】

// 2013/4/15 の日付情報を取得

objDate = new Date( "2013/4/15" );
y = objDate.getFullYear();
m = objDate.getMonth()+1;
d = objDate.getDate();
document.write( y , "/" , m , "/" , d );

※ Date オブジェクトで表すことができる日付の範囲は、1970/01/01 の前後の約285,616 年です。

● getYear メソッド

【機能】	Dateオブジェクトの年を返します。
【書式】	year = objDate.getYear()
【戻り値】	2000 年の場合は、100 を返します。

【例】

objDate = new Date();
year = objDate.getYear();

※ 下位互換性のみを目的として提供されます。代わりに、getFullYear メソッドを使用してください。
※ Internet Explorer では、2000 年の場合は、100 を返します。

● getFullYear メソッド

【機能】	Dateオブジェクトの年を返します。
【書式】	year = objDate.getFullYear()
【戻り値】	年 (4桁)

【例】

objDate = new Date();
year = objDate.getFullYear();

● getMonth メソッド

【機能】	Dateオブジェクトの月を返します。
【書式】	month = objDate.getMonth()
【戻り値】	月　※ 0 (1 月) ～ 11 (12 月) になります。

【例】

objDate = new Date();
month = objDate.getMonth();

● getDate メソッド

【機能】	Dateオブジェクトの日を返します。
【書式】	date = objDate.getDate()
【戻り値】	日 ( 1 ～ 31 )

【例】

objDate = new Date();
date = objDate.getDate();

● getDay メソッド

【機能】	Dateオブジェクトの曜日を返します。
【書式】	day = objDate.getDay()
【戻り値】	曜日　※ 0 (日曜日) ～ 6 (土曜日) を返します。

【例】

objDate = new Date();
day = objDate.getDay();

【例】

week = new Array("日","月","火","水","木","金","土");
objDate = new Date();
day = week[objDate.getDay()];

● getHours メソッド

【機能】	Dateオブジェクトの時を返します。
【書式】	hours = objDate.getHours()
【戻り値】	時 ( 0 ～ 23 )

【例】

objDate = new Date();
hours = objDate.getHours();

● getMinutes メソッド

【機能】	Dateオブジェクトの分を返します。
【書式】	minutes = objDate.getMinutes()
【戻り値】	分 ( 0 ～ 59 )

【例】

objDate = new Date();
minutes = objDate.getMinutes();

● getSeconds メソッド

【機能】	Dateオブジェクトの秒を返します。
【書式】	seconds = objDate.getSeconds()
【戻り値】	秒 ( 0 ～ 59 )

【例】

objDate = new Date();
seconds = objDate.getSeconds();

● getMilliseconds メソッド

【機能】	Dateオブジェクトのミリ秒を返します。
【書式】	ms = objDate.getMilliseconds()
【戻り値】	ミリ秒 ( 0 ～ 999 )

【例】

objDate = new Date();
ms = objDate.getMilliseconds();

● getUTCFullYear メソッド

【機能】	Dateオブジェクトの年 (世界協定時刻:UTC) を返します。
【書式】	year = objDate.getUTCFullYear()
【戻り値】	年 (4桁)

【例】

objDate = new Date();
year = objDate.getUTCFullYear();

● getUTCMonth メソッド

【機能】	Dateオブジェクトの月 (世界協定時刻:UTC) を返します。
【書式】	month = objDate.getUTCMonth()
【戻り値】	月　※ 0 (1 月) ～ 11 (12 月) になります。

【例】

objDate = new Date();
month = objDate.getUTCMonth();

● getUTCDate メソッド

【機能】	Dateオブジェクトの日 (世界協定時刻:UTC) を返します。
【書式】	date = objDate.getUTCDate()
【戻り値】	日 ( 1 ～ 31 )

【例】

objDate = new Date();
date = objDate.getUTCDate();

● getUTCDay メソッド

【機能】	Dateオブジェクトの曜日 (世界協定時刻:UTC) を返します。
【書式】	day = objDate.getUTCDay()
【戻り値】	曜日　※ 0 (日曜日) ～ 6 (土曜日) を返します。

【例】

objDate = new Date();
day = objDate.getUTCDay();

【例】

week = new Array("日","月","火","水","木","金","土");
objDate = new Date();
day = week[objDate.getUTCDay()];

● getUTCHours メソッド

【機能】	Dateオブジェクトの時 (世界協定時刻:UTC) を返します。
【書式】	hours = objDate.getUTCHours()
【戻り値】	時 ( 0 ～ 23 )

【例】

objDate = new Date();
hours = objDate.getUTCHours();

● getUTCMinutes メソッド

【機能】	Dateオブジェクトの分 (世界協定時刻:UTC) を返します。
【書式】	minutes = objDate.getUTCMinutes()
【戻り値】	分 ( 0 ～ 59 )

【例】

objDate = new Date();
minutes = objDate.getUTCMinutes();

● getUTCSeconds メソッド

【機能】	Dateオブジェクトの秒 (世界協定時刻:UTC) を返します。
【書式】	seconds = objDate.getUTCSeconds()
【戻り値】	秒 ( 0 ～ 59 )

【例】

objDate = new Date();
seconds = objDate.getUTCSeconds();

● getUTCMilliseconds メソッド

【機能】	Dateオブジェクトのミリ秒 (世界協定時刻:UTC) を返します。
【書式】	ms = objDate.getUTCMilliseconds()
【戻り値】	ミリ秒 ( 0 ～ 999 )

【例】

objDate = new Date();
ms = objDate.getUTCMilliseconds();

● getTime メソッド

【機能】	経過ミリ秒を返します。
【書式】	time = objDate.getTime()
【戻り値】	1970/1/1 00:00:00 と Date オブジェクトの日時の差をミリ秒単位で返します。日付の範囲は、1970/1/1 00:00:00 の前後およそ 285,616 年です。負数は、1970 年以前の日付を示します。

【例】

objDate = new Date();
time = objDate.getTime();

【例】

objDate = new Date( 1970, 0, 1 );
time = objDate.getTime();

【例】

objDate = new Date( 1970, 0, 1, 9, 0, 0 );
time = objDate.getTime();

● valueOf メソッド

【機能】	経過ミリ秒を返します。
【書式】	time = objDate.valueOf()
【戻り値】	1970/1/1 00:00:00 と Date オブジェクトの日時の差をミリ秒単位で返します。日付の範囲は、1970/1/1 00:00:00 の前後およそ 285,616 年です。負数は、1970 年以前の日付を示します。これは、getTime と同じ値です。

【例】

objDate = new Date();
time = objDate.valueOf();

● getTimezoneOffset メソッド

【機能】	ローカルコンピューターの時刻と世界協定時刻 (UTC) との差を返します。
【書式】	timezoneOffset = objDate.getTimezoneOffset()
【戻り値】	差を分で返します。

【例】

objDate = new Date();
timezoneOffset = objDate.getTimezoneOffset();

● setYear メソッド

【機能】	Dateオブジェクトの年をセットします。
【書式】	objDate.setFullYear( numYear )

【例】

objDate = new Date();
objDate.setYear( 99 );
y = objDate.getFullYear();
M = objDate.getMonth() + 1;
d = objDate.getDate();
h = objDate.getHours();
m = objDate.getMinutes();
s = objDate.getSeconds();
f = objDate.getMilliseconds();
document.write(y,"/",M,"/",d," ",h,":",m,":",s,".",f);

※ 1900 ～ 1999 年の場合は、年から 1900 を引いた数値を指定します。この範囲に含まれない年の場合は、4 桁の数値を指定します。

● setFullYear メソッド

【機能】	Dateオブジェクトの年をセットします。
【書式】	objDate.setFullYear( numYear[, numMonth[, numDate]] )

【例】

objDate = new Date();
objDate.setFullYear( 2000 );
y = objDate.getFullYear();
M = objDate.getMonth() + 1;
d = objDate.getDate();
h = objDate.getHours();
m = objDate.getMinutes();
s = objDate.getSeconds();
f = objDate.getMilliseconds();
document.write(y,"/",M,"/",d," ",h,":",m,":",s,".",f);

● setMonth メソッド

【機能】	Dateオブジェクトの月をセットします。※ 月は、0 (1 月) ～ 11 (12 月) です。
【書式】	objDate.setMonth( numMonth[, dateVal] )

【例】	objDate = new Date(); objDate.setMonth( -1 ); // 12月へ変更 y = objDate.getFullYear(); M = objDate.getMonth() + 1; d = objDate.getDate(); h = objDate.getHours(); m = objDate.getMinutes(); s = objDate.getSeconds(); f = objDate.getMilliseconds(); document.write(y,"/",M,"/",d," ",h,":",m,":",s,".",f);
【例】	objDate = new Date( 2013, 4, 30 ); // 2013/5/30をセット objDate.setMonth( 3 ); // 4月へ変更 y = objDate.getFullYear(); M = objDate.getMonth() + 1; d = objDate.getDate(); h = objDate.getHours(); m = objDate.getMinutes(); s = objDate.getSeconds(); f = objDate.getMilliseconds(); document.write(y,"/",M,"/",d," ",h,":",m,":",s,".",f);
【例】	objDate = new Date( 2013, 4, 31 ); // 2013/5/31をセット objDate.setMonth( 3 ); // 4月へ変更 y = objDate.getFullYear(); M = objDate.getMonth() + 1; d = objDate.getDate(); h = objDate.getHours(); m = objDate.getMinutes(); s = objDate.getSeconds(); f = objDate.getMilliseconds(); document.write(y,"/",M,"/",d," ",h,":",m,":",s,".",f);

  ※ 月の値は 0月～ 11月でセットします。
  ※ numMonth に 0 ～ 11 以外の値のセットした場合、例えば、-1 を指定した場合は、去年の12月になります。
  ※ 5/31 の時に 4月へ変更した場合は 4月は30日までしかないので、4/31 → 5/1 になります。

● setDate メソッド

【機能】	Dateオブジェクトの日をセットします。
【書式】	objDate.setDate( numDate )

【例】

objDate = new Date();
objDate.setDate( 0 );
y = objDate.getFullYear();
M = objDate.getMonth() + 1;
d = objDate.getDate();
h = objDate.getHours();
m = objDate.getMinutes();
s = objDate.getSeconds();
f = objDate.getMilliseconds();
document.write(y,"/",M,"/",d," ",h,":",m,":",s,".",f);

※ numDateに 1 ～ 28/29/30/31 以外の値をセットした場合、例えば、0 をセットした場合は、先月の末日になります。

● setHours メソッド

【機能】	Dateオブジェクトの時をセットします。
【書式】	objDate.setHours( numHours[, numMin[, numSec[, numMilli]]] )

【例】

objDate = new Date();
objDate.setHours( -1 );
y = objDate.getFullYear();
M = objDate.getMonth() + 1;
d = objDate.getDate();
h = objDate.getHours();
m = objDate.getMinutes();
s = objDate.getSeconds();
f = objDate.getMilliseconds();
document.write(y,"/",M,"/",d," ",h,":",m,":",s,".",f);

※ numHours に 0 ～ 23 以外の値をセットした場合、例えば、-1 をセットした場合は、昨日の23時になります。

● setMinutes メソッド

【機能】	Dateオブジェクトの分をセットします。
【書式】	objDate.setMinutes( numMinutes[, numSeconds[, numMilli]] )

【例】

objDate = new Date();
objDate.setMinutes( -1 );
y = objDate.getFullYear();
M = objDate.getMonth() + 1;
d = objDate.getDate();
h = objDate.getHours();
m = objDate.getMinutes();
s = objDate.getSeconds();
f = objDate.getMilliseconds();
document.write(y,"/",M,"/",d," ",h,":",m,":",s,".",f);

※ numMinutes に 0 ～ 59 以外の値をセットした場合、例えば、-1 をセットした場合は、1時間前の59分になります。

● setSeconds メソッド

【機能】	Dateオブジェクトの秒をセットします。
【書式】	objDate.setSeconds( numSeconds[, numMilli] )

【例】

objDate = new Date();
objDate.setSeconds( -1 );
y = objDate.getFullYear();
M = objDate.getMonth() + 1;
d = objDate.getDate();
h = objDate.getHours();
m = objDate.getMinutes();
s = objDate.getSeconds();
f = objDate.getMilliseconds();
document.write(y,"/",M,"/",d," ",h,":",m,":",s,".",f);

※ numSeconds に 0 ～ 59 以外の値をセットした場合、例えば、-1 をセットした場合は、1分前の59分になります。

● setMilliseconds メソッド

【機能】	Dateオブジェクトのミリ秒をセットします。
【書式】	objDate.setMilliseconds( numMilli )

【例】

objDate = new Date();
objDate.setMilliseconds( -1 );
y = objDate.getFullYear();
M = objDate.getMonth() + 1;
d = objDate.getDate();
h = objDate.getHours();
m = objDate.getMinutes();
s = objDate.getSeconds();
f = objDate.getMilliseconds();
document.write(y,"/",M,"/",d," ",h,":",m,":",s,".",f);

※ numMilli に 0 ～ 999 以外の値をセットした場合、例えば、-1 をセットした場合は、1秒前の999ミリ秒になります。

● setUTCFullYear メソッド

【機能】	Dateオブジェクトの年 (世界協定時刻:UTC) をセットします。
【書式】	objDate.setUTCFullYear( numYear[, numMonth[, numDate]] )

【例】

objDate = new Date();
objDate.setUTCFullYear( 2000 );
y = objDate.getUTCFullYear();
M = objDate.getUTCMonth() + 1;
d = objDate.getUTCDate();
h = objDate.getUTCHours();
m = objDate.getUTCMinutes();
s = objDate.getUTCSeconds();
f = objDate.getUTCMilliseconds();
document.write(y,"/",M,"/",d," ",h,":",m,":",s,".",f);

● setUTCMonth メソッド

【機能】	Dateオブジェクトの月 (世界協定時刻:UTC) をセットします。※ 月は、0 (1 月) ～ 11 (12 月) です。
【書式】	objDate.setUTCMonth( numMonth[, dateVal] )

【例】

objDate = new Date();
objDate.setUTCMonth( -1 );
y = objDate.getUTCFullYear();
M = objDate.getUTCMonth() + 1;
d = objDate.getUTCDate();
h = objDate.getUTCHours();
m = objDate.getUTCMinutes();
s = objDate.getUTCSeconds();
f = objDate.getUTCMilliseconds();
document.write(y,"/",M,"/",d," ",h,":",m,":",s,".",f);

※ numMonth に 0 ～ 11 以外の値のセットした場合、例えば、-1 を指定した場合は、去年の12月になります。

● setUTCDate メソッド

【機能】	Dateオブジェクトの日 (世界協定時刻:UTC) をセットします。
【書式】	objDate.setUTCDate( numDate )

【例】

objDate = new Date();
objDate.setUTCDate( 0 );
y = objDate.getUTCFullYear();
M = objDate.getUTCMonth() + 1;
d = objDate.getUTCDate();
h = objDate.getUTCHours();
m = objDate.getUTCMinutes();
s = objDate.getUTCSeconds();
f = objDate.getUTCMilliseconds();
document.write(y,"/",M,"/",d," ",h,":",m,":",s,".",f);

※ numDateに 1 ～ 28/29/30/31 以外の値をセットした場合、例えば、0 をセットした場合は、先月の末日になります。

● setUTCHours メソッド

【機能】	Dateオブジェクトの時 (世界協定時刻:UTC) をセットします。
【書式】	objDate.setUTCHours( numHours[, numMin[, numSec[, numMilli]]] )

【例】

objDate = new Date();
objDate.setUTCHours( -1 );
y = objDate.getUTCFullYear();
M = objDate.getUTCMonth() + 1;
d = objDate.getUTCDate();
h = objDate.getUTCHours();
m = objDate.getUTCMinutes();
s = objDate.getUTCSeconds();
f = objDate.getUTCMilliseconds();
document.write(y,"/",M,"/",d," ",h,":",m,":",s,".",f);

※ numHours に 0 ～ 23 以外の値をセットした場合、例えば、-1 をセットした場合は、昨日の23時になります。

● setUTCMinutes メソッド

【機能】	Dateオブジェクトの分 (世界協定時刻:UTC) をセットします。
【書式】	objDate.setUTCMinutes( numMinutes[, numSeconds[, numMilli]] )

【例】

objDate = new Date();
objDate.setUTCMinutes( -1 );
y = objDate.getUTCFullYear();
M = objDate.getUTCMonth() + 1;
d = objDate.getUTCDate();
h = objDate.getUTCHours();
m = objDate.getUTCMinutes();
s = objDate.getUTCSeconds();
f = objDate.getUTCMilliseconds();
document.write(y,"/",M,"/",d," ",h,":",m,":",s,".",f);

※ numMinutes に 0 ～ 59 以外の値をセットした場合、例えば、-1 をセットした場合は、1時間前の59分になります。

● setUTCSeconds メソッド

【機能】	Dateオブジェクトの秒 (世界協定時刻:UTC) をセットします。
【書式】	objDate.setUTCSeconds( numSeconds[, numMilli] )

【例】

objDate = new Date();
objDate.setUTCSeconds( -1 );
y = objDate.getUTCFullYear();
M = objDate.getUTCMonth() + 1;
d = objDate.getUTCDate();
h = objDate.getUTCHours();
m = objDate.getUTCMinutes();
s = objDate.getUTCSeconds();
f = objDate.getUTCMilliseconds();
document.write(y,"/",M,"/",d," ",h,":",m,":",s,".",f);

※ numSeconds に 0 ～ 59 以外の値をセットした場合、例えば、-1 をセットした場合は、1分前の59分になります。

● setUTCMilliseconds メソッド

【機能】	Dateオブジェクトのミリ秒 (世界協定時刻:UTC) をセットします。
【書式】	objDate.setUTCMilliseconds( numMilli )

【例】

objDate = new Date();
objDate.setUTCMilliseconds( -1 );
y = objDate.getUTCFullYear();
M = objDate.getUTCMonth() + 1;
d = objDate.getUTCDate();
h = objDate.getUTCHours();
m = objDate.getUTCMinutes();
s = objDate.getUTCSeconds();
f = objDate.getUTCMilliseconds();
document.write(y,"/",M,"/",d," ",h,":",m,":",s,".",f);

※ numMilli に 0 ～ 999 以外の値をセットした場合、例えば、-1 をセットした場合は、1秒前の999ミリ秒になります。

● setTime メソッド

【機能】	経過ミリ秒をセットします。
【書式】	objDate.setTime( milliseconds )

【例】

objDate = new Date();
objDate.setTime( 0 );
y = objDate.getFullYear();
M = objDate.getMonth() + 1;
d = objDate.getDate();
h = objDate.getHours();
m = objDate.getMinutes();
s = objDate.getSeconds();
f = objDate.getMilliseconds();
document.write(y,"/",M,"/",d," ",h,":",m,":",s,".",f);

  ※ 1970/1/1 00:00:00 からの経過ミリ秒をセットします。
  ※ 日付の範囲は、1970/1/1 00:00:00 の前後およそ 285,616 年です。
  ※ 負数は、1970 年以前の日付を示します。

● toDateString メソッド

【機能】	Dateオブジェクトの日付情報を文字列へ変換します。
【書式】	objDate.toDateString()

【例】

objDate = new Date();
strDate = objDate.toDateString();

● toGMTString メソッド

【機能】	Dateオブジェクトの日付情報を文字列(グリニッジ標準時:GMT) へ変換します。
【書式】	objDate.toGMTString()

【例】

objDate = new Date();
strDate = objDate.toGMTString();

※ toGMTString メソッドは廃止されました。現在、以前のバージョンとの互換性のためだけに残されています。代わりに、toUTCString メソッドの使用をお勧めします。

● toUTCString メソッド

【機能】	Dateオブジェクトの日付情報を文字列(世界協定時刻:UTC) へ変換します。
【書式】	objDate.toUTCString()

【例】

objDate = new Date();
strDate = objDate.toUTCString();

● toISOString メソッド　IE6-8

【機能】	Dateオブジェクトの日付情報を文字列(ISO形式) へ変換します。
【書式】	objDate.toISOString()

【例】

objDate = new Date();
strDate = objDate.toISOString();

● toLocaleDateString メソッド

【機能】	Dateオブジェクトの日付情報を文字列(現在のロケール) へ変換します。
【書式】	objDate.toLocaleDateString()

【例】

objDate = new Date();
strDate = objDate.toLocaleDateString();

● toLocaleTimeString メソッド

【機能】	Dateオブジェクトの時刻情報を文字列(現在のロケール) へ変換します。
【書式】	objDate.toLocaleTimeString()

【例】

objDate = new Date();
strDate = objDate.toLocaleTimeString();

● toString メソッド

【機能】	Dateオブジェクトの日付情報を文字列(現在のロケール) へ変換します。
【書式】	objDate.toString()

【例】

objDate = new Date();
strDate = objDate.toString();