요약
기본 객체
날짜와 시간을 작업할 수 있습니다.
생성
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
등의 메소드를 포함하고 있습니다.
아래 예제는 timeA
와 timeB
의 시간차를 밀리초 단위로 반환합니다.
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.
속성
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.
정적 메소드
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.
메소드
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.
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
usingtoISOString()
. Intended for use byJSON.stringify()
. Date.prototype.toGMTString()
- Returns a string representing the
Date
based on the GMT (UT) time zone. UsetoUTCString()
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 theObject.prototype.toSource()
method. Date.prototype.toString()
- Returns a string representing the specified
Date
object. Overrides theObject.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 theObject.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) 단위의 시간