Date

공헌자 숫자: 2명

요약

기본 객체

날짜와 시간을 작업할 수 있습니다.

생성

Date 객체는 다음과 같이 생성한다:

new Date();
new Date(value);
new Date(dateString);
new Date(year, month[, day[, hour[, minutes[, seconds[, milliseconds]]]]]);

파라미터

milliseconds
1970년 1월 1일 00:00:00 부터의 시간을 밀리초 단위로 표현한 정수값.
dateString
날짜를 표현하는 문자열값. 문자열은 parse 메소드에 의해 인식가능한 형식이어야 한다.
yr_num, mo_num, day_num
날짜의 각 부분을 표현하는 정수값. 월(month)부분은 0부터 11까지의 값을 가지며, 0이 1월을, 11이 12월을 가리킨다.
hr_num, min_num, sec_num, ms_num
날짜의 각 부분을 표현하는 정수값.

설명

만일 아무런 전달값도 없다면, 생성자는 Date 객체가 로컬 시간에 따른 현재 날짜와 시간값을 가지도록 합니다. 만약 전달값 중 일부만 있다면, 나머지 빠진 전달값들은 모두 0이 됩니다. 모든 전달값을 제공하려면 최소한 연도, 월, 일은 포함해야 하며, 시, 분, 초 그리고 밀리초는 생략할 수 있습니다.

날짜는 1970년 1월 1일 0시 (UTC) 부터 밀리초 단위로 측정됩니다. 하루는 86,400,000 밀리초입니다. Date 객체는 1970년 1월 1일 (UTC) 을 기준으로 -100,000,000 일부터 100,000,000일까지의 값을 가질 수 있습니다.

Date 객체는 모든 플랫폼에서 똑같은 동작을 제공합니다.

Date 객체는 로컬시간대의 함수처럼 사용할 수 있는 몇개의 UTC (universal) 메소드를 포함하고 있습니다. UTC는 흔히 그리니치 평균시(GMT, Greenwich Mean Time)로 알려져있으며, 세계 표준시로서 사용되고 있습니다. 로컬 시간은 JavaScript 가 실행되는 컴퓨터의 시간입니다.

밀레니엄 계산(2000년대도 계산하는 것)과의 호환성을 위해, 연도를 지정할 때는 반드시 4자리로 써야 합니다. 예를 들자면, 98이 아닌 1998로 써야한다는 뜻입니다. 연도 지정을 돕기 위해, JavaScript는 getFullYear, setFullYear, getUTCFullYear, setUTCFullYear 등의 메소드를 포함하고 있습니다.

아래 예제는 timeAtimeB의 시간차를 밀리초 단위로 반환합니다.

timeA = new Date();
// 여기에 어떤 동작을 하는 코드를 넣으세요.
timeB = new Date();
timeDifference = timeB - timeA;

하위 호환성

JavaScript 1.2 이하 버전

Date 객체는 다음과 같이 동작합니다:

  • 1970년 이전의 날짜는 불가능합니다.
  • JavaScript depends on platform-specific date facilities and behavior; the behavior of the Date object varies from platform to platform.
  • The getDay and getUTCDay methods behave differently on differently localized platforms (e.g. a British and a German Windows). Specifically, 0 (zero) can be returned either for Sunday or Monday.

속성

For properties available on Date instances, see Properties of Date instances.
Date.prototype
Date 객체에 추가 속성을 부여할 수 있다.
Date.length
The value of Date.length is 7. This is the number of arguments handled by the constructor.

정적 메소드

 

For methods available on Date instances, see Methods of Date instances.
Date.now()
Returns the numeric value corresponding to the current time - the number of milliseconds elapsed since 1 January 1970 00:00:00 UTC.
Date.parse()
Parses a string representation of a date and returns the number of milliseconds since 1 January, 1970, 00:00:00, UTC. Date.UTC() Accepts the same parameters as the longest form of the constructor (i.e. 2 to 7) and returns the number of milliseconds since 1 January, 1970, 00:00:00 UTC.
Methods inherited from Function:

메소드

For methods available on Date instances, see Methods of Date instances.
Date.now()
Returns the numeric value corresponding to the current time - the number of milliseconds elapsed since 1 January 1970 00:00:00 UTC.
Date.parse()
Parses a string representation of a date and returns the number of milliseconds since 1 January, 1970, 00:00:00, UTC.
Date.UTC()
Accepts the same parameters as the longest form of the constructor (i.e. 2 to 7) and returns the number of milliseconds since 1 January, 1970, 00:00:00 UTC.
Methods inherited from Function:

JavaScript Date instances

All Date instances inherit from Date.prototype. The prototype object of the Date constructor can be modified to affect all Date instances.

Date.prototype Methods

Getter

Date.prototype.getDate()
주중의 몇번째 요일인지 반환
Date.prototype.getDay()
한달의 몇번째 날인지 반환
Date.prototype.getFullYear()
Returns the year (4 digits for 4-digit years) of the specified date according to local time.
Date.prototype.getHours()
Returns the hour (0-23) in the specified date according to local time.
Date.prototype.getMilliseconds()
Returns the milliseconds (0-999) in the specified date according to local time.
Date.prototype.getMinutes()
Returns the minutes (0-59) in the specified date according to local time.
Date.prototype.getMonth()
Returns the month (0-11) in the specified date according to local time.
Date.prototype.getSeconds()
Returns the seconds (0-59) in the specified date according to local time.
Date.prototype.getTime()
Returns the numeric value of the specified date as the number of milliseconds since January 1, 1970, 00:00:00 UTC (negative for prior times).
Date.prototype.getTimezoneOffset()
Returns the time-zone offset in minutes for the current locale.
Date.prototype.getUTCDate()
Returns the day (date) of the month (1-31) in the specified date according to universal time.
Date.prototype.getUTCDay()
Returns the day of the week (0-6) in the specified date according to universal time.
Date.prototype.getUTCFullYear()
Returns the year (4 digits for 4-digit years) in the specified date according to universal time.
Date.prototype.getUTCHours()
Returns the hours (0-23) in the specified date according to universal time.
Date.prototype.getUTCMilliseconds()
Returns the milliseconds (0-999) in the specified date according to universal time.
Date.prototype.getUTCMinutes()
Returns the minutes (0-59) in the specified date according to universal time.
Date.prototype.getUTCMonth()
Returns the month (0-11) in the specified date according to universal time.
Date.prototype.getUTCSeconds()
Returns the seconds (0-59) in the specified date according to universal time.
Date.prototype.getYear()
Returns the year (usually 2-3 digits) in the specified date according to local time. Use getFullYear() instead.

Setter

Date.prototype.setDate()
Sets the day of the month for a specified date according to local time.
Date.prototype.setFullYear()
Sets the full year (e.g. 4 digits for 4-digit years) for a specified date according to local time.
Date.prototype.setHours()
Sets the hours for a specified date according to local time.
Date.prototype.setMilliseconds()
Sets the milliseconds for a specified date according to local time.
Date.prototype.setMinutes()
Sets the minutes for a specified date according to local time.
Date.prototype.setMonth()
Sets the month for a specified date according to local time.
Date.prototype.setSeconds()
Sets the seconds for a specified date according to local time.
Date.prototype.setTime()
Sets the Date object to the time represented by a number of milliseconds since January 1, 1970, 00:00:00 UTC, allowing for negative numbers for times prior.
Date.prototype.setUTCDate()
Sets the day of the month for a specified date according to universal time.
Date.prototype.setUTCFullYear()
Sets the full year (e.g. 4 digits for 4-digit years) for a specified date according to universal time.
Date.prototype.setUTCHours()
Sets the hour for a specified date according to universal time.
Date.prototype.setUTCMilliseconds()
Sets the milliseconds for a specified date according to universal time.
Date.prototype.setUTCMinutes()
Sets the minutes for a specified date according to universal time.
Date.prototype.setUTCMonth()
Sets the month for a specified date according to universal time.
Date.prototype.setUTCSeconds()
Sets the seconds for a specified date according to universal time.
Date.prototype.setYear()
Sets the year (usually 2-3 digits) for a specified date according to local time. Use setFullYear() instead.

Conversion getter

Date.prototype.toDateString()
Returns the "date" portion of the Date as a human-readable string.
Date.prototype.toISOString()
Converts a date to a string following the ISO 8601 Extended Format.
Date.prototype.toJSON()
Returns a string representing the Date using toISOString(). Intended for use by JSON.stringify().
Date.prototype.toGMTString()
Returns a string representing the Date based on the GMT (UT) time zone. Use toUTCString() instead.
Date.prototype.toLocaleDateString()
Returns a string with a locality sensitive representation of the date portion of this date based on system settings.
Date.prototype.toLocaleFormat()
Converts a date to a string, using a format string.
Date.prototype.toLocaleString()
Returns a string with a locality sensitive representation of this date. Overrides the Object.prototype.toLocaleString() method.
Date.prototype.toLocaleTimeString()
Returns a string with a locality sensitive representation of the time portion of this date based on system settings.
Date.prototype.toSource()
Returns a string representing the source for an equivalent Date object; you can use this value to create a new object. Overrides the Object.prototype.toSource() method.
Date.prototype.toString()
Returns a string representing the specified Date object. Overrides the Object.prototype.toString() method.
Date.prototype.toTimeString()
Returns the "time" portion of the Date as a human-readable string.
Date.prototype.toUTCString()
Converts a date to a string using the UTC timezone.
Date.prototype.valueOf()
Returns the primitive value of a Date object. Overrides the Object.prototype.valueOf() method.

 

예제

예제: 날짜를 지정하는 여러가지 방법

아래 예제는 날짜를 지정하는 몇가지 방법을 보여줍니다:

var today = new Date();
var birthday = new Date("December 17, 1995 03:24:00");
var birthday = new Date(95,11,17);
var birthday = new Date(95,11,17,3,24,0);

예제: 경과시간 계산

아래 예제는 두 개의 시간 사이의 시간을 어떻게 계산하는지 보여줍니다:

// 정적 메소드 사용
var start = Date.now();

// 시간때우기용 이벤트를 이곳에 넣어둡니다:
doSomethingForALongTime();
var end = Date.now();
var elapsed = end - start; // 밀리초(seconds) 단위의 시간
// 객체가 있다면
var start = new Date();

// 시간때우기용 이벤트를 이곳에 넣어둡니다:
doSomethingForALongTime();
var end = new Date();
var elapsed = end.getTime() - start.getTime(); // 밀리초(seconds) 단위의 시간

문서 태그 및 공헌자

태그: 
Contributors to this page: teoli, 행복한고니
최종 변경: teoli,
사이드바 숨기기