Date

표준 빌트인 객체인 Date는 날짜와 시간을 다루기 빌트인 객체이며 생성자 함수입니다.

• UTC(세계 협정시)는 국제 표준시를 의미하며 기술적인 표기에서는 UTC가 사용됩니다.

• KST(한국 표준시)는 UTC에 9시간을 더한 시간입니다. 즉, KST는 UTC보다 9시간 더 빠릅니다.

현재 날짜와 시간은 자바스크립트 코드가 실행된 시스템의 시계에 의해 결정됩니다.

Date 생성자 함수

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

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

Date 생성자 함수로 객체를 생성하는 방법은 4가지가 존재합니다.

1. new Date()

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

new Date(); // Wed Sep 08 2021 15:30:21 GMT+0900 (한국 표준시)

2. new Date(milliSeconds)

Date 생성자 함수에 숫자 타입의 밀리초를 인수로 전달하면 1970년 1월 1일 00:00:00(UTC)를 기점으로 인수로 전달된 밀리초만큼 경과된 날짜와 시간을 나타내는 Date 객체를 반환합니다.

/*
1s = 1000ms
1m = 60s * 1000ms = 60000ms
1h = 60m * 60000ms = 3600000ms
1d = 24h * 3600000ms = 86400000ms
*/
new Date(86400000); // Fri Jan 02 1970 09:00:00 GMT+0900 (한국 표준시)

3. new Date(dateString)

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

new Date('Sep 08, 2021 10:00:00'); // Wed Sep 08 2021 10:00:00 GMT+0900 (한국 표준시)

new Date('2021/09/08/10:00:00'); // Wed Sep 08 2021 10:00:00 GMT+0900 (한국 표준시)

4. new Date(year, month [, date, hour, minute, second, millisecond])

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

연, 월을 지정하지 않은 경우 1970년 1월 1일 00:00:00(UTC)를 나타내는 Date 객체를 반환합니다.

Date 정적 메서드

1. Date.now

1970년 1월 1일 00:00:00(UTC)을 기점으로 현재 시간까지 경과한 밀리초를 숫자로 반환합니다.

2. Date.parse

1970년 1월 1일 00:00:00(UTC)을 기점으로 인수로 전달받은 지정 시간까지의 밀리초를 숫자로 반환합니다.

이때 인수는 new Date("dataString")의 인수와 동일합니다.

// UTC
Date.parse('Jan 2, 1970 00:00:00 UTC'); // 86400000

// KST
Date.parse('Jan 2, 1970 09:00:00'); // 86400000

// KST
Date.parse('1970/01/02/09:00:00'); // 86400000

3. Date.UTC

1970년 1월 1일 00:00:00(UTC)를 기점으로 인수로 전달된 지정시간까지의 밀리초를 반환합니다. 이때 Date.UTC 메서드의 인수는 new Date(year, month [,date, hour, minute, second, millisecond])와 같은 형식의 인수를 사용해야 합니다.

Date.UTC 메서드의 인수는 로컬 타임(KST)가 아닌 UTC로 해석됩니다.

Date.UTC(1970, 0, 2); // 86400000

Date 프로토타입 메서드

1. Date.prototype.getFullYear

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

new Date('2021/07/24').getFullYear(); // 2021

2. Date.prototype.setFullYear

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

const date = new Date();
date.setFullYear(2021);
date.getFullYear(); // 2021

3. Date.prototype.getMonth

Date 객체의 월을 나타내는 정수를 반환합니다. 이때 0부터 시작해서 0은 1월 11은 12월을 나타냅니다.

new Date('2020/07/24').getMonth(); // 7

4. Date.prototype.setMonth

Date 객체의 월을 나타내는 정수를 설정합니다. 월 이외에 옵션으로 일을 설정할 수 있습니다.이때 0부터 시작해서 0은 1월 11은 12월을 나타냅니다.

const date = new Date();
date.setMonth(0);
date.getMonth(); // 0 , 1월을 나타낸다.

4. Date.prototype.getDate

Date 객체의 일을 나타내는 정수(1~31)를 반환합니다.

new Date('2021/09/08').getDate(); // 8

5. Date.prototype.setDate

Date 객체의 일을 나타내는 정수를 설정합니다.

const today = new Date();
today.setDate(1);
today.getDate(); // 1

6. Date.prototype.getDay

Date 객체의 요일(0~6)을 나타내는 정수를 반환합니다. 0은 일요일 6은 토요일을 의미합니다.

7. Date.prototype.getHours

Date 객체의 시간을 나타내는 정수를 반환합니다.

new Date('2020/07/24/12:00').getHours(); // 12

8. Date.prototype.setHours

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

const date = new Date();
date.setHours(7);
date.getHOurs(); // 7

9. Date.prototype.getMinutes

Date 객체의 분을 나타내는 정수를 반환합니다.

new Date('2021/09/09/21:35').getMinute(); // 35

10. Date.prototype.setMinutes

Date 객체의 분을 나타내는 정수를 설정합니다. 분 이외에 옵션으로 초, 밀리초를 설정할 수 있습니다.

const date = new Date();
date.setMinutes(10);
date.getMinutes(); // 10

11. Date.prototype.getSeconds

Date 객체의 초를 나타내는 정수를 반환합니다.

new Date('2021/09/09/21:37:10').getSeconds(); // 10

12. Date.prototype.setSeconds

Date 객체의 초를 나타내는 정수를 설정할 수 있습니다. 초 이외에 옵션으로 밀리초도 설정할 수 있습니다.

const date = new Date();
date.setSeconds(10);
date.getSeconds(); // 10

13. Date.prototype.getMilliseconds

Date 객체의 밀리초를 나타내는 정수를 반환합니다.

new Date('2021/09/09/10:10:10:21').getMilliseconds(); // 21

14. Date.prototype.setMilliseconds

Date 객체의 밀리초를 나타내는 정수를 설정합니다.

cosnt date = new Date()
date.setMilliseconds(51);
date.getMilliseconds(); // 51

15. Date.prototpye.getTime

1970년 1월 1일 00시 00분 00초(UTC)를 JS에서 같이 간 기점으로 경고된 밀리초를 발환합니다.

new Date('2020/07/24/12:30').getTime(); // 1595561400000

16. Date.prototype.setTime

1970년 1월 1일 00시 00분 00초 (UTC)부터 결겨된 밀리츠로를 갖는 Date객체를 생성한다.

17. Date.protype.toDateString

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

const date = new Date('2020/07/24/12:30');
date.toDateString(); // Fri Jul 24 2020

18.Date.prototype.toTimeString

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

const date = new Date('2020/07/24/12:30');
date.toTimeString(); // 12:30:00 GMT+090 (대한민국 표준시)

17. Date.prototype.toISOString

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

const today = new Date('2020/7/24/12:30');
today.toISOString(); // 2020-07-24T03:30:00.000Z

18. Date.prototype.toLocaleString

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

const today = new Date('2020/7/24/12:30');
today.toLocaleString('ko-KR'); // 2020. 7. 24. 오후 12:30:00
today.toLocaleString('en-US'); // 7/24/2020. 12:30:00 PM

19. Date.prototype.toLocaleTimeString

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

const today = new Date('2020/7/24/12:30');
today.toLocaleTimeString('ko-KR'); // 오후 12:30:00
today.toLocaleTimeString('en-US'); // 12:30:00 PM