30. Date

표준 빌트인 객체인 Date는 날짜와 시간(연, 월, 일, 시, 분, 초, 밀리초)을 위한 메서드를 제공하는 빌트인 객체이면서 생성자 함수다.

 

UCT는 국제 표준시를 말한다. KST는 한국 표준시로 UCT에 9시간을 더한 시간이다. 즉, KST는 UTC보다 9시간이 빠르다. 현재 날짜와 시간은 자바스크립트가 실행된 시스템의 시계에 의해 결정된다.

 

Date 생성자 함수

Date 생성자 함수로 생성한 Date 객체는 내부적으로 날짜와 시간을 나타내는 정수값을 갖는다. 이 값은 1970년 1월 1일 00:00:00(UTC)을 기점으로 Date 객체가 나타내는 날짜와 시간까지의 밀리초를 나타낸다.

 

Date 생성자 함수로 생성한 Date 객체는 기본적으로 현재 날짜와 시간을 나타내는 정수값을 가진다. 현재 날짜와 시간이 아닌 다른 날짜와 시간을 다루고 싶은 경우 Date 생성자 함수에 명시적으로 해당 날짜와 시간 정보를 인수로 지정한다.

new Date()

Date 생성자 함수를 인수 없이 new 연산자와 함께 호출하면 현재 날짜와 시간을 가지는 Date 객체를 반환한다. Date 객체는 내부적으로 날짜와 시간을 나타내는 정수값을 갖지만 Date 객체를 콘솔에 출력하면 기본적으로 날짜와 시간 정보를 출력한다.

Date 생성자 함수를 new 연산자 없이 호출하면 Date 객체를 반환하지 않고 날짜와 시간 정보를 나타내는 문자열을 반환한다.

new Date(milliseconds)

Date 생성자 함수에 숫자 타입의 밀리초를 인수로 전달하면 기준시를 기점으로 인수로 전달된 밀리초만큼 경과한 날짜와 시간을 나타내는 Date 객체를 반환한다.

new Date(dateString)

Date 생성자 함수에 날짜와 시간을 나타내는 문자열을 인수로 전달하면 지정된 날짜와 시간을 나타내는 Date 객체를 반환한다. 이때 인수로 전달한 문자열은 Date.parse 메서드에 의해 해석 가능한 형식이어야 한다.

new Date(year, month[, day, hour, minute, second, millisecond])

Date 생성자 함수에 연, 월, 일, 시, 분, 초, 밀리초를 의미하는 숫자를 인수로 전달하면 지정된 날짜와 시간을 나타내는 Date 객체를 반환한다. 이때 연, 월은 반드시 지정해야 한다. 지정하지 않은 옵션 정보는 0 또는 1로 초기화된다.

 

Date 메서드

Date.now

기준시를 기점으로 현재 시간까지 경과한 밀리초를 숫자로 반환한다.

Date.parse

기준시를 기점으로 인수로 전달된 지정 시간(문자열)까지의 밀리초를 숫자로 반환한다.

Date.UTC

UTC 기준시를 기점으로 인수로 전달된 지정 시간까지의 밀리초를 숫자로 반환한다. 인수는 (year, month[, day, hour, minute, second, millisecond])와 같은 형식으로 전달해야 한다. 인수는 로컬 타임이 아닌 UTC로 인식된다. 

Date.prototype.getFullYear

Date 객체의 연도를 나타내는 정수를 반환한다.

Date.prototype.setFullYear

Date 객체에 연도를 나타내는 정수를 설정한다. 연도 이외에 옵션으로 월, 일도 설정할 수 있다.

Date.prototype.getMonth

Date 객체의 월을 나타내는 0~11의 정수를 반환한다. 0부터 시작하여 1월은 0, 12월은 11이다.

Date.prototype.setMonth

Date 객체에 월을 나타내는 0~11의 정수를 설정한다. 월 이외에 옵션으로 일도 설정할 수 있다.

Date.prototype.getDate

Date 객체의 날짜(1~31)를 나타내는 정수를 설정한다.

Date.prototype.setDate

Date 객체에 날짜(1~31)를 나타내는 정수를 설정한다.

Date.prototype.getDay

Date 객체의 요일(0~6)을 나타내는 정수를 반환한다.

요일	반환값
일요일	0
월요일	1
화요일	2
수요일	3
목요일	4
금요일	5
토요일	6

Date.prototype.getHours

Date 객체의 시간(0~23)을 나타내는 정수를 반환한다.

Date.prototype.setHours

Date 객체에 시간(0~23)을 나타내는 정수를 설정한다. 시간 이외에 옵션으로 분, 초, 밀리초도 설정할 수 있다.

Date.prototype.getMinutes

Date 객체의 분(0~59)을 나타내는 정수를 반환한다.

Date.prototype.setMinutes

Date 객체에 분(0~59)을 나타내는 정수를 설정한다. 분 이외에 옵션으로 초, 밀리초도 설정할 수 있다.

Date.prototype.getSeconds

Date 객체의 초(0~59)를 나타내는 정수를 반환한다.

Date.prototype.setSeconds

Date 객체에 초(0~59)를 나타내는 정수를 설정한다. 초 이외에 옵션으로 밀리초도 설정할 수 있다.

Date.prototype.getMilliseconds

Date 객체의 밀리초(0~999)를 나타내는 정수를 반환한다.

Date.prototype.setMilliseconds

Date 객체에 밀리초(0~999)를 나타내는 정수를 설정한다.

Date.prototype.getTime

기준시를 기점으로 Date 객체의 시간까지 경과된 밀리초를 반환한다.

Date.prototype.setTime

Date 객체에 기준시를 기점으로 경과된 밀리초를 설정한다.

Date.prototype.getTimezoneOffset

UTC와 Date 객체에 지정된 로캘 시간과의 차이를 분 단위로 반환한다. 

Date.prototype.toDateString

사람이 읽을 수 있는 형식의 문자열로 Date 객체의 날짜를 반환한다. 

Date.prototype.toTimeString

사람이 읽을 수 있는 형식으로 Date 객체의 시간을 표현한 문자열을 반환한다.

Date.prototype.toISOString

ISO 8601 형식으로 Date 객체의 날짜와 시간을 표현한 문자열을 반환한다.

Date.prototype.toLocaleString

인수로 전달한 로캘(ko-KR, en-US, ja-JP...)을 기준으로 Date 객체의 날짜와 시간을 표현한 문자열을 반환한다. 인수를 생략한 경우 브라우저가 동작 중인 시스템의 로캘을 적용한다.

Date.prototype.toLocaleTimeString

인수로 전달한 로캘을 기준으로 Date 객체의 시간을 표현한 문자열을 반환한다. 인수를 생략한 경우 브라우저가 동작 중인 시스템의 로캘을 적용한다.