日付操作

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

お品書き


● 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 )

dateVal1970 年 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();